Skip to content

Converters and Visualizer

About the Converter API

The Converter API is a new feature in the v0.12.x release of SpectraFit with major focus on:

  1. Data Validation
  2. Settings Management

In general, input and data files are converted to the internal data format, which are dictionaries for the input data and pandas dataframes for the data files. The Converter API is realized by using the ABC-class and the @abstractmethod decorator, while the File API is using the pydantic library.

Meta Data Converter Class

Abstract base class for the converter plugins.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Converter

Bases: ABC

Abstract base class for the converter plugin.

The abstract base class is used to define the interface for the converter plugins:

  • get_args: Get the arguments from the command line.
  • convert: Convert the input file to the output file.
  • call: Call the converter plugin.

Currently used for:

  • Convertion of the input file.
  • Convertion of the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/converter.py
Python
class Converter(ABC):
    """Abstract base class for the converter plugin.

    The abstract base class is used to define the interface for the converter plugins:

    - get_args: Get the arguments from the command line.
    - convert: Convert the input file to the output file.
    - __call__: Call the converter plugin.

    Currently used for:

    - Convertion of the input file.
    - Convertion of the output file.
    """

    @abstractmethod
    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                 additional information beyond the command line arguments.

        Raises:
            ValueError: If the output file format is not supported.
        """

    @staticmethod
    @abstractmethod
    def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
        """Convert the input file to the target file format.

        It is an abstract method and must be implemented in the derived class.

        Args:
            infile (Path): Input file as a path object.
            file_format (str): Target file format.

        Returns:
            MutableMapping[str, Any]: Converted file as a dictionary.
        """

    @abstractmethod
    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the data to the target file format.

        Args:
            data (Any): Data to save.
            fname (Path): Filename of the target file.
            export_format (str): Target file format.
        """

    @abstractmethod
    def __call__(self) -> None:
        """Call the converter plugin."""

__call__() abstractmethod

Call the converter plugin.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/converter.py
Python
@abstractmethod
def __call__(self) -> None:
    """Call the converter plugin."""

convert(infile, file_format) abstractmethod staticmethod

Convert the input file to the target file format.

It is an abstract method and must be implemented in the derived class.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

Input file as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

Target file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any]: Converted file as a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/converter.py
Python
@staticmethod
@abstractmethod
def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
    """Convert the input file to the target file format.

    It is an abstract method and must be implemented in the derived class.

    Args:
        infile (Path): Input file as a path object.
        file_format (str): Target file format.

    Returns:
        MutableMapping[str, Any]: Converted file as a dictionary.
    """

get_args() abstractmethod

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Raises:

Type Description
ValueError

If the output file format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/converter.py
Python
@abstractmethod
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
             additional information beyond the command line arguments.

    Raises:
        ValueError: If the output file format is not supported.
    """

save(data, fname, export_format) abstractmethod

Save the data to the target file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

Data to save.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

Filename of the target file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

Target file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/converter.py
Python
@abstractmethod
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the data to the target file format.

    Args:
        data (Any): Data to save.
        fname (Path): Filename of the target file.
        export_format (str): Target file format.
    """

Input and Output File Converter for object-oriented formats

Convert the input and output files to the preferred file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

FileConverter

Bases: Converter

Convert the input and output file to the preferred file format.

Supported file formats

Currently supported file formats:

-[x] JSON -[x] YAML (YML) -[x] TOML (LOCK for the lock file)

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Attributes:

Name Type Description
choices Set[str]

The choices for the file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/file_converter.py
Python
class FileConverter(Converter):
    """Convert the input and output file to the preferred file format.

    !!! info "Supported file formats"

        Currently supported file formats:

        -[x] JSON
        -[x] YAML (YML)
        -[x] TOML (LOCK for the lock file)

    Attributes:
        choices (Set[str]): The choices for the file format.
    """

    choices = {"json", "yaml", "yml", "toml", "lock"}

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parser = argparse.ArgumentParser(
            description="Converter for 'SpectraFit' input and output files.",
            usage="%(prog)s [options] infile",
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="Filename of the 'SpectraFit' input or output file.",
        )
        parser.add_argument(
            "-f",
            "--file-format",
            help="File format for the conversion.",
            type=str,
            choices=self.choices,
        )
        parser.add_argument(
            "-e",
            "--export-format",
            help="File format for the export.",
            type=str,
            default="json",
            choices=self.choices,
        )
        return vars(parser.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
        """Convert the input file to the output file.

        Args:
            infile (Path): The input file as a path object.
            file_format (str): The output file format.

        Raises:
            ValueError: If the input file format is not supported.

        Returns:
            MutableMapping[str, Any] : The converted file as a dictionary.
        """
        if file_format not in FileConverter.choices:
            raise ValueError(f"The input file format '{file_format}' is not supported.")

        return read_input_file(infile)

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the converted file.

        Raises:
            ValueError: If the input file format is identical with the output format.
            ValueError: If the output file format is not supported.

        Args:
            data (Any): The converted file as a dictionary.
            fname (Path): The input file as a path object.
            export_format (str): The output file format.
        """
        if fname.suffix[1:] == export_format:
            raise ValueError(
                f"The input file suffix '{fname.suffix[1:]}' is similar to the"
                f" output file format '{export_format}'."
                "Please use a different output file suffix."
            )

        if export_format not in self.choices:
            raise ValueError(
                f"The output file format '{export_format}' is not supported."
            )

        if export_format == "json":
            with fname.with_suffix(f".{export_format}").open(
                "w", encoding="utf-8"
            ) as f:
                json.dump(data, f, indent=4)
        elif export_format in {"yaml", "yml"}:
            with fname.with_suffix(f".{export_format}").open(
                "w", encoding="utf-8"
            ) as f:
                yaml.dump(data, f, default_flow_style=False)
        elif export_format in {"toml", "lock"}:
            with fname.with_suffix(f".{export_format}").open("wb+") as f:
                tomli_w.dump(dict(**data), f)

    def __call__(self) -> None:
        """Run the converter via cmd commands."""
        args = self.get_args()
        self.save(
            data=self.convert(infile=args["infile"], file_format=args["file_format"]),
            fname=args["infile"],
            export_format=args["export_format"],
        )

__call__()

Run the converter via cmd commands.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/file_converter.py
Python
def __call__(self) -> None:
    """Run the converter via cmd commands."""
    args = self.get_args()
    self.save(
        data=self.convert(infile=args["infile"], file_format=args["file_format"]),
        fname=args["infile"],
        export_format=args["export_format"],
    )

convert(infile, file_format) staticmethod

Convert the input file to the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

The output file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the input file format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any] : The converted file as a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/file_converter.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
    """Convert the input file to the output file.

    Args:
        infile (Path): The input file as a path object.
        file_format (str): The output file format.

    Raises:
        ValueError: If the input file format is not supported.

    Returns:
        MutableMapping[str, Any] : The converted file as a dictionary.
    """
    if file_format not in FileConverter.choices:
        raise ValueError(f"The input file format '{file_format}' is not supported.")

    return read_input_file(infile)

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/file_converter.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parser = argparse.ArgumentParser(
        description="Converter for 'SpectraFit' input and output files.",
        usage="%(prog)s [options] infile",
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="Filename of the 'SpectraFit' input or output file.",
    )
    parser.add_argument(
        "-f",
        "--file-format",
        help="File format for the conversion.",
        type=str,
        choices=self.choices,
    )
    parser.add_argument(
        "-e",
        "--export-format",
        help="File format for the export.",
        type=str,
        default="json",
        choices=self.choices,
    )
    return vars(parser.parse_args())

save(data, fname, export_format)

Save the converted file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Raises:

Type Description
ValueError

If the input file format is identical with the output format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

ValueError

If the output file format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

The converted file as a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The input file as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The output file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/file_converter.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the converted file.

    Raises:
        ValueError: If the input file format is identical with the output format.
        ValueError: If the output file format is not supported.

    Args:
        data (Any): The converted file as a dictionary.
        fname (Path): The input file as a path object.
        export_format (str): The output file format.
    """
    if fname.suffix[1:] == export_format:
        raise ValueError(
            f"The input file suffix '{fname.suffix[1:]}' is similar to the"
            f" output file format '{export_format}'."
            "Please use a different output file suffix."
        )

    if export_format not in self.choices:
        raise ValueError(
            f"The output file format '{export_format}' is not supported."
        )

    if export_format == "json":
        with fname.with_suffix(f".{export_format}").open(
            "w", encoding="utf-8"
        ) as f:
            json.dump(data, f, indent=4)
    elif export_format in {"yaml", "yml"}:
        with fname.with_suffix(f".{export_format}").open(
            "w", encoding="utf-8"
        ) as f:
            yaml.dump(data, f, default_flow_style=False)
    elif export_format in {"toml", "lock"}:
        with fname.with_suffix(f".{export_format}").open("wb+") as f:
            tomli_w.dump(dict(**data), f)

command_line_runner()

Run the converter from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/file_converter.py
Python
def command_line_runner() -> None:
    """Run the converter from the command line."""
    FileConverter()()

Data Converter for rational data formats like CSV, Excel, etc.

Transform the input data to a CSV file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

DataConverter

Bases: Converter

Convert the data files to a CSV file.

Supported file formats

Currently supported file formats:

-[x] ATHENA -[x] TXT -[ ] more to come

DataConverter class can be also used in the Jupyter notebook.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
class DataConverter(Converter):
    """Convert the data files to a CSV file.

    !!! info "Supported file formats"

        Currently supported file formats:

        -[x] ATHENA
        -[x] TXT
        -[ ] more to come

        `DataConverter` class can be also used in the Jupyter notebook.
    """

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parser = argparse.ArgumentParser(
            description="Converter for 'SpectraFit' from data files to CSV files.",
            usage="%(prog)s [options] infile",
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="Filename of the data file to convert.",
        )
        parser.add_argument(
            "-f",
            "--file-format",
            help="File format for the conversion.",
            type=str,
            choices=choices,
        )
        parser.add_argument(
            "-e",
            "--export-format",
            help="File format for the export.",
            type=str,
            default="csv",
            choices=choices_export,
        )
        return vars(parser.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
        """Convert the input file to the target file format.

        Args:
            infile (Path): Input file as a path object.
            file_format (str): Target file format.

        Raises:
            ValueError: If the file format is not supported.

        Returns:
            MutableMapping[str, Any]: The converted data as a MutableMapping[str, Any],
                which belongs to DataFrame.
        """
        if file_format.upper() not in choices:
            raise ValueError(f"File format '{file_format}' is not supported.")

        if callable(DataFormats.__dict__[file_format].names):
            names = DataFormats.__dict__[file_format].names(infile)
        else:
            names = DataFormats.__dict__[file_format].names
        DataFormats.__dict__[file_format].names = names

        return pd.read_csv(
            infile, **DataFormats.__dict__[file_format].dict(exclude={"file_suffixes"})
        )

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the converted data to a CSV file.

        Raises:
            ValueError: If the export format is not supported.

        Args:
            data (Any): The converted data, which is a pandas DataFrame.
            fname (Path): The file name of the data file.
            export_format (str): The file format of the exported file.
        """
        if export_format.lower() not in choices_export:
            raise ValueError(f"Export format '{export_format}' is not supported.")
        data.to_csv(fname.with_suffix(f".{export_format}"), index=False)

    def __call__(self) -> None:
        """Run the converter."""
        args = self.get_args()
        self.save(
            data=self.convert(
                args["infile"],
                args["file_format"],
            ),
            fname=args["infile"],
            export_format=args["export_format"],
        )

__call__()

Run the converter.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
def __call__(self) -> None:
    """Run the converter."""
    args = self.get_args()
    self.save(
        data=self.convert(
            args["infile"],
            args["file_format"],
        ),
        fname=args["infile"],
        export_format=args["export_format"],
    )

convert(infile, file_format) staticmethod

Convert the input file to the target file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

Input file as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

Target file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the file format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any]: The converted data as a MutableMapping[str, Any], which belongs to DataFrame.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
    """Convert the input file to the target file format.

    Args:
        infile (Path): Input file as a path object.
        file_format (str): Target file format.

    Raises:
        ValueError: If the file format is not supported.

    Returns:
        MutableMapping[str, Any]: The converted data as a MutableMapping[str, Any],
            which belongs to DataFrame.
    """
    if file_format.upper() not in choices:
        raise ValueError(f"File format '{file_format}' is not supported.")

    if callable(DataFormats.__dict__[file_format].names):
        names = DataFormats.__dict__[file_format].names(infile)
    else:
        names = DataFormats.__dict__[file_format].names
    DataFormats.__dict__[file_format].names = names

    return pd.read_csv(
        infile, **DataFormats.__dict__[file_format].dict(exclude={"file_suffixes"})
    )

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parser = argparse.ArgumentParser(
        description="Converter for 'SpectraFit' from data files to CSV files.",
        usage="%(prog)s [options] infile",
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="Filename of the data file to convert.",
    )
    parser.add_argument(
        "-f",
        "--file-format",
        help="File format for the conversion.",
        type=str,
        choices=choices,
    )
    parser.add_argument(
        "-e",
        "--export-format",
        help="File format for the export.",
        type=str,
        default="csv",
        choices=choices_export,
    )
    return vars(parser.parse_args())

save(data, fname, export_format)

Save the converted data to a CSV file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Raises:

Type Description
ValueError

If the export format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

The converted data, which is a pandas DataFrame.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The file name of the data file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The file format of the exported file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/data_converter.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the converted data to a CSV file.

    Raises:
        ValueError: If the export format is not supported.

    Args:
        data (Any): The converted data, which is a pandas DataFrame.
        fname (Path): The file name of the data file.
        export_format (str): The file format of the exported file.
    """
    if export_format.lower() not in choices_export:
        raise ValueError(f"Export format '{export_format}' is not supported.")
    data.to_csv(fname.with_suffix(f".{export_format}"), index=False)

DataFormats dataclass

Data formats.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
@dataclass(frozen=True)
class DataFormats:
    """Data formats."""

    ATHENA = athena_format
    TXT = txt_format

command_line_runner()

Run the converter from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
def command_line_runner() -> None:
    """Run the converter from the command line."""
    DataConverter()()

get_athena_column(fname, comment='#')

Get the header of the file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
fname Path

The file name of the data file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
comment str

The comment marker. Defaults to "#".

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

'#'

Returns:

Type Description
Optional[List[str]]

Optional[List[str]]: The column names of the data file as a list.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/data_converter.py
Python
def get_athena_column(fname: Path, comment: str = "#") -> Optional[List[str]]:
    """Get the header of the file.

    Args:
        fname (Path): The file name of the data file.
        comment (str, optional): The comment marker. Defaults to "#".

    Returns:
        Optional[List[str]]: The column names of the data file as a list.

    """
    with fname.open(encoding="utf-8") as f:
        data = f.read()
        lines = data.splitlines()
        return next(
            (
                lines[i - 1].split(comment)[-1].split()
                for i, line in enumerate(lines)
                if re.match(r"^\s*\d", line)
            ),
            None,
        )

Pkl Converter for pickle files

Transform the raw pkl data into a CSV files.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

ExportData

Export the data to a file.

General information

The data is exported to a file. The file format is determined by the file extension of the output file. The supported file formats are:

-[x] npy -[x] npz -[x] pkl -[x] pkl.gz

Classical file formats like CSV, JSON, TOML, etc. are not supported. In case of CSV, the conversion from unstructured data to a structured format is not trivial. In case of JSON and TOML, the data is not the conversion from numpy arrays to lists is very costly. Therefore, the data is exported to a pickly file as the preferred format.

About NumPy

The data is exported to a NumPy file can cause some challenge for the loading of the data. The data is exported as a dictionary with numpy as numpy arrays. The data can be loaded with the following code:

Python
import numpy as np

data = np.load("data.npy", allow_pickle=True).item()

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
class ExportData:
    """Export the data to a file.

    !!! info "General information"

        The data is exported to a file. The file format is determined by the file
        extension of the output file. The supported file formats are:

        -[x] npy
        -[x] npz
        -[x] pkl
        -[x] pkl.gz

        Classical file formats like `CSV`, `JSON`, `TOML`, etc. are not supported.
        In case of `CSV`, the conversion from unstructured data to a structured
        format is not trivial. In case of `JSON` and `TOML`, the data is not
        the conversion from numpy arrays to lists is very costly. Therefore, the
        data is exported to a pickly file as the preferred format.

    !!! warning "About NumPy"

        The data is exported to a NumPy file can cause some challenge for the
        loading of the data. The data is exported as a dictionary with numpy
        as numpy arrays. The data can be loaded with the following code:

        ```python
        import numpy as np

        data = np.load("data.npy", allow_pickle=True).item()
        ```
    """

    def __init__(self, data: Dict[str, Any], fname: Path, export_format: str) -> None:
        """Export the data to a file.

        Args:
            data (Dict[str, Any]): The data to export.
            fname (Path): The filename of the output file.
            export_format (str): The file format of the output file.
        """
        self.data = data
        self.fname = fname.with_suffix(f".{export_format}")
        self.export_format = export_format

    def __call__(self) -> None:
        """Export the data to a file."""
        if self.export_format in {"npy", "npz"}:
            self.to_numpy()
        elif self.export_format in {"pkl", pkl_gz}:
            self.to_pickle()

    def to_numpy(self) -> None:
        """Export the data to a numpy file."""
        _data: Any = self.data
        if self.export_format.lower() == "npy":
            np.save(self.fname, _data)
        elif self.export_format.lower() == "npz":
            np.savez(self.fname, data=_data)

    def to_pickle(self) -> None:
        """Export the data to a pickle file."""
        if self.export_format.lower() == "pkl":
            with self.fname.open("wb") as f:
                pickle.dump(self.data, f)
        elif self.export_format.lower() == pkl_gz:
            with gzip.open(self.fname, "wb") as f:
                pickle.dump(self.data, f)

    @staticmethod
    def numpy2list(data: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
        """Convert the arrays of list dictionaries to a list of dictionaries with list.

        Args:
            data (List[Dict[str, Any]]): The data to convert.

        Returns:
            List[Dict[str, Any]]: The converted data.
        """
        return [
            {k: v.tolist() for k, v in d.items() if isinstance(v, np.ndarray)}
            for d in data
        ]

__call__()

Export the data to a file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def __call__(self) -> None:
    """Export the data to a file."""
    if self.export_format in {"npy", "npz"}:
        self.to_numpy()
    elif self.export_format in {"pkl", pkl_gz}:
        self.to_pickle()

__init__(data, fname, export_format)

Export the data to a file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Dict[str, Any]

The data to export.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The filename of the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The file format of the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pkl_converter.py
Python
def __init__(self, data: Dict[str, Any], fname: Path, export_format: str) -> None:
    """Export the data to a file.

    Args:
        data (Dict[str, Any]): The data to export.
        fname (Path): The filename of the output file.
        export_format (str): The file format of the output file.
    """
    self.data = data
    self.fname = fname.with_suffix(f".{export_format}")
    self.export_format = export_format

numpy2list(data) staticmethod

Convert the arrays of list dictionaries to a list of dictionaries with list.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data List[Dict[str, Any]]

The data to convert.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
List[Dict[str, Any]]

List[Dict[str, Any]]: The converted data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
@staticmethod
def numpy2list(data: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
    """Convert the arrays of list dictionaries to a list of dictionaries with list.

    Args:
        data (List[Dict[str, Any]]): The data to convert.

    Returns:
        List[Dict[str, Any]]: The converted data.
    """
    return [
        {k: v.tolist() for k, v in d.items() if isinstance(v, np.ndarray)}
        for d in data
    ]

to_numpy()

Export the data to a numpy file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def to_numpy(self) -> None:
    """Export the data to a numpy file."""
    _data: Any = self.data
    if self.export_format.lower() == "npy":
        np.save(self.fname, _data)
    elif self.export_format.lower() == "npz":
        np.savez(self.fname, data=_data)

to_pickle()

Export the data to a pickle file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def to_pickle(self) -> None:
    """Export the data to a pickle file."""
    if self.export_format.lower() == "pkl":
        with self.fname.open("wb") as f:
            pickle.dump(self.data, f)
    elif self.export_format.lower() == pkl_gz:
        with gzip.open(self.fname, "wb") as f:
            pickle.dump(self.data, f)

PklConverter

Bases: Converter

Convert pkl data to a CSV files.

General information

The pkl data is converted to a CSV file. The CSV file is saved in the same directory as the input file. The name of the CSV file is the same as the input file with the suffix .csv and prefixed with the name of the 'major' keys in the pkl file. Furthermore, a graph of the data is optionally saved as a PDF file to have a visual representation of the data structure.

Supported file formats

Currently supported file formats:

-[x] pkl -[x] pkl.gz -[x] ...

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Attributes:

Name Type Description
choices_fformat Set[str]

The choices for the file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

choices_export Set[str]

The choices for the export format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
class PklConverter(Converter):
    """Convert pkl data to a CSV files.

    !!! info "General information"

        The pkl data is converted to a CSV file. The CSV file is saved in the same
        directory as the input file. The name of the CSV file is the same as the
        input file with the suffix `.csv` and prefixed with the name of the
        'major' keys in the pkl file. Furthermore, a graph of the data is optionally
        saved as a PDF file to have a visual representation of the data structure.

    !!! info "Supported file formats"

        Currently supported file formats:

        -[x] pkl
        -[x] pkl.gz
        -[x] ...


    Attributes:
        choices_fformat (Set[str]): The choices for the file format.
        choices_export (Set[str]): The choices for the export format.
    """

    choices_fformat = {"latin1", "utf-8", "utf-16", "utf-32"}
    choices_export = {"npy", "npz", "pkl", pkl_gz}

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parser = argparse.ArgumentParser(
            description="Converter for 'SpectraFit' from pkl files to CSV files.",
            usage="%(prog)s [options] infile",
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="Filename of the pkl file to convert.",
        )
        parser.add_argument(
            "-f",
            "--file-format",
            help="File format for the optional encoding of the pickle file."
            " Default is 'latin1'.",
            type=str,
            default="latin1",
            choices=self.choices_fformat,
        )
        parser.add_argument(
            "-e",
            "--export-format",
            help="File format for export of the output file. Default is 'pkl'.",
            type=str,
            default="pkl",
            choices=self.choices_export,
        )
        return vars(parser.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> Dict[str, Any]:
        """Convert the input file to the output file.

        Args:
            infile (Path): The input file of the as a path object.
            file_format (str): The output file format.

        Returns:
            Dict[str, Any]: The data as a dictionary, which can be a nested dictionary
        """

        def _convert(
            data_values: Dict[str, Any], _key: Optional[List[str]] = None
        ) -> List[Dict[str, Any]]:
            """Convert the data to a list of dictionaries.

            The new key is the old key plus all the subkeys. The new value is the
            value of the subkey if the value is an instance of an array.

            For avoiding `pylint` errors, the `_key` argument is set to `None` by
            default and is set to an empty list if it is `None`. This is done to
            avoid the `pylint` error `dangerous-default-value`. The `_key` argument
            is used to keep track of the keys of the nested dictionary. Furthermore,
            the `_key` argument is used to create the new key for the new dictionary.

            Finally, the new dictionary is appended to the list of dictionaries.

            Args:
                data_values (Dict[str, Any]): The data as a dictionary.

            Returns:
                List[Dict[str, Any]]: The data as a list of dictionaries.
            """
            data_list = []
            if _key is None:
                _key = []
            for key, value in data_values.items():
                if isinstance(value, dict):
                    _key.append(str(key))
                    data_list.extend(_convert(value, _key))
                    _key.pop()
                elif isinstance(value, np.ndarray):
                    data_list.append({"_".join(_key + [key]): value})
            return data_list

        data_dict = {}
        for key, value in pkl2any(infile, file_format).items():
            if isinstance(value, dict):
                data_dict[key] = _convert(value)
        return data_dict

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the converted pickle data to a file.

        Args:
            data (Any): The converted nested dictionary of the pkl data.
            fname (Path): The filename of the output file.
            export_format (str): The file format of the output file.

        Raises:
            ValueError: If the export format is not supported.
        """
        if export_format.lower() not in self.choices_export:
            raise ValueError(f"Unsupported file format '{export_format}'.")

        fname = pure_fname(fname)

        for key, value in data.items():
            _fname = Path(f"{fname}_{key}").with_suffix(f".{export_format}")
            ExportData(data=value, fname=_fname, export_format=export_format)()

    def __call__(self) -> None:
        """Run the converter."""
        args = self.get_args()
        data = self.convert(args["infile"], args["file_format"])
        self.save(data, args["infile"], args["export_format"])

__call__()

Run the converter.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def __call__(self) -> None:
    """Run the converter."""
    args = self.get_args()
    data = self.convert(args["infile"], args["file_format"])
    self.save(data, args["infile"], args["export_format"])

convert(infile, file_format) staticmethod

Convert the input file to the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file of the as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

The output file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: The data as a dictionary, which can be a nested dictionary

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> Dict[str, Any]:
    """Convert the input file to the output file.

    Args:
        infile (Path): The input file of the as a path object.
        file_format (str): The output file format.

    Returns:
        Dict[str, Any]: The data as a dictionary, which can be a nested dictionary
    """

    def _convert(
        data_values: Dict[str, Any], _key: Optional[List[str]] = None
    ) -> List[Dict[str, Any]]:
        """Convert the data to a list of dictionaries.

        The new key is the old key plus all the subkeys. The new value is the
        value of the subkey if the value is an instance of an array.

        For avoiding `pylint` errors, the `_key` argument is set to `None` by
        default and is set to an empty list if it is `None`. This is done to
        avoid the `pylint` error `dangerous-default-value`. The `_key` argument
        is used to keep track of the keys of the nested dictionary. Furthermore,
        the `_key` argument is used to create the new key for the new dictionary.

        Finally, the new dictionary is appended to the list of dictionaries.

        Args:
            data_values (Dict[str, Any]): The data as a dictionary.

        Returns:
            List[Dict[str, Any]]: The data as a list of dictionaries.
        """
        data_list = []
        if _key is None:
            _key = []
        for key, value in data_values.items():
            if isinstance(value, dict):
                _key.append(str(key))
                data_list.extend(_convert(value, _key))
                _key.pop()
            elif isinstance(value, np.ndarray):
                data_list.append({"_".join(_key + [key]): value})
        return data_list

    data_dict = {}
    for key, value in pkl2any(infile, file_format).items():
        if isinstance(value, dict):
            data_dict[key] = _convert(value)
    return data_dict

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parser = argparse.ArgumentParser(
        description="Converter for 'SpectraFit' from pkl files to CSV files.",
        usage="%(prog)s [options] infile",
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="Filename of the pkl file to convert.",
    )
    parser.add_argument(
        "-f",
        "--file-format",
        help="File format for the optional encoding of the pickle file."
        " Default is 'latin1'.",
        type=str,
        default="latin1",
        choices=self.choices_fformat,
    )
    parser.add_argument(
        "-e",
        "--export-format",
        help="File format for export of the output file. Default is 'pkl'.",
        type=str,
        default="pkl",
        choices=self.choices_export,
    )
    return vars(parser.parse_args())

save(data, fname, export_format)

Save the converted pickle data to a file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

The converted nested dictionary of the pkl data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The filename of the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The file format of the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the export format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the converted pickle data to a file.

    Args:
        data (Any): The converted nested dictionary of the pkl data.
        fname (Path): The filename of the output file.
        export_format (str): The file format of the output file.

    Raises:
        ValueError: If the export format is not supported.
    """
    if export_format.lower() not in self.choices_export:
        raise ValueError(f"Unsupported file format '{export_format}'.")

    fname = pure_fname(fname)

    for key, value in data.items():
        _fname = Path(f"{fname}_{key}").with_suffix(f".{export_format}")
        ExportData(data=value, fname=_fname, export_format=export_format)()

command_line_runner()

Run the command line script.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_converter.py
Python
def command_line_runner() -> None:
    """Run the command line script."""
    PklConverter()()

About pickle file and the PklVisualizer

In addition to exploring the nested structure of the Python's pickle file, the PklVisualizer provides two methods to visualize the data:

  1. As graph via networkx and matplotlib
  2. As json file with used types

Visualize the pkl file as a graph.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

PklVisualizer

Bases: Converter

Visualize the pkl data as a graph.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Attributes:

Name Type Description
choices_fformat Set[str]

The choices for the file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

choices_export Set[str]

The choices for the export format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
class PklVisualizer(Converter):
    """Visualize the pkl data as a graph.

    Attributes:
        choices_fformat (Set[str]): The choices for the file format.
        choices_export (Set[str]): The choices for the export format.
    """

    choices_fformat = {"latin1", "utf-8", "utf-16", "utf-32"}
    choices_export = {"png", "pdf", "jpg", "jpeg"}

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parser = argparse.ArgumentParser(
            description="Converter for 'SpectraFit' from pkl files to a graph.",
            usage="%(prog)s [options] infile",
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="Filename of the pkl file to convert to graph.",
        )
        parser.add_argument(
            "-f",
            "--file-format",
            help="File format for the optional encoding of the pickle file."
            " Default is 'latin1'.",
            type=str,
            default="latin1",
            choices=self.choices_fformat,
        )
        parser.add_argument(
            "-e",
            "--export-format",
            help="File extension for the graph export.",
            type=str,
            default="pdf",
            choices=self.choices_export,
        )

        return vars(parser.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> Dict[str, Any]:
        """Convert the input file to the output file.

        Args:
            infile (Path): The input file of the as a path object.
            file_format (str): The encoding of the pickle file.

        Raises:
            ValueError: If the data is not a dictionary.

        Returns:
            Dict[str, Any]: The data as a dictionary, which can be a nested dictionary.
        """
        data = PklVisualizer().get_type(pkl2any(infile, encoding=file_format))
        if not isinstance(data, dict):
            raise ValueError(f"Data is not a dictionary: {data}")
        graph = PklVisualizer().create_graph(fname=infile, data_dict=data)

        pos = nx.kamada_kawai_layout(graph, scale=2)
        nx.draw_networkx_nodes(
            graph, pos, node_size=100, node_color="lightblue", alpha=0.8
        )
        nx.draw_networkx_edges(graph, pos, width=0.5, edge_color="grey", alpha=0.5)
        nx.draw_networkx_labels(graph, pos, font_size=10, font_family="sans-serif")
        plt.axis("off")
        return data

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the graph to a file and the data and their types to a json file.

        Args:
            data (Any): The data to save, which can be a nested dictionary.
            fname (Path): The filename of the file to save.
            export_format (str): The file format to save the graph to.

        Raises:
            ValueError: If the export format is not supported.
        """
        if export_format.lower() not in self.choices_export:
            raise ValueError(f"Export format '{export_format}' is not supported.")

        plt.savefig(
            pure_fname(fname).with_suffix(f".{export_format}"),
            format=export_format,
        )

        with open(pure_fname(fname).with_suffix(".json"), "w+", encoding="utf-8") as f:
            json.dump(data, f, indent=4)

    def get_type(self, value: Any) -> Union[Dict[str, Any], str]:
        """Get the type of the value.

        Args:
            value (Any): The value to get the type from.

        Returns:
            Union[Dict[str, Any], str]: The type of the value.
        """
        if isinstance(value, dict):
            return {key: self.get_type(value) for key, value in value.items()}
        if isinstance(value, np.ndarray):
            return f"{type(value)} of shape {value.shape}"
        return str(type(value))

    def add_nodes(self, graph: nx.DiGraph, data_dict: Dict[str, Any]) -> None:
        """Add nodes to the graph.

        Args:
            graph (nx.DiGraph): The graph to add nodes to.
            data_dict (Dict[str, Any]): The data dictionary to get the nodes from.
        """
        for key, value in data_dict.items():
            graph.add_node(key)
            if isinstance(value, dict):
                for item in value:
                    graph.add_edge(key, item)
                    graph.add_node(item)
                self.add_nodes(graph=graph, data_dict=value)
            elif "of shape" in str(value):
                value = value.split("of shape")
                graph.add_node(value[0])
                graph.add_edge(key, value[0])

                graph.add_node(value[-1])
                graph.add_edge(value[0], value[-1])

            else:
                graph.add_node(value)
                graph.add_edge(key, value)

    def create_graph(self, fname: Path, data_dict: Dict[str, Any]) -> nx.DiGraph:
        """Create the graph.

        Args:
            fname (Path): The filename of the file to create the graph from.
            data_dict (Dict[str, Any]): The data dictionary to create the graph from.

        Returns:
            nx.DiGraph: The graph created from the data dictionary.
        """
        graph = nx.DiGraph()
        graph.add_node(str(fname.name))
        for key in data_dict:
            graph.add_edge(str(fname.name), key)

        self.add_nodes(graph=graph, data_dict=data_dict)
        return graph

    def __call__(self) -> None:
        """Create the graph and save it as a PDF file."""
        args = self.get_args()
        self.save(
            data=self.convert(args["infile"], args["file_format"]),
            fname=args["infile"],
            export_format=args["export_format"],
        )
        plt.show()

__call__()

Create the graph and save it as a PDF file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def __call__(self) -> None:
    """Create the graph and save it as a PDF file."""
    args = self.get_args()
    self.save(
        data=self.convert(args["infile"], args["file_format"]),
        fname=args["infile"],
        export_format=args["export_format"],
    )
    plt.show()

add_nodes(graph, data_dict)

Add nodes to the graph.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
graph DiGraph

The graph to add nodes to.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
data_dict Dict[str, Any]

The data dictionary to get the nodes from.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pkl_visualizer.py
Python
def add_nodes(self, graph: nx.DiGraph, data_dict: Dict[str, Any]) -> None:
    """Add nodes to the graph.

    Args:
        graph (nx.DiGraph): The graph to add nodes to.
        data_dict (Dict[str, Any]): The data dictionary to get the nodes from.
    """
    for key, value in data_dict.items():
        graph.add_node(key)
        if isinstance(value, dict):
            for item in value:
                graph.add_edge(key, item)
                graph.add_node(item)
            self.add_nodes(graph=graph, data_dict=value)
        elif "of shape" in str(value):
            value = value.split("of shape")
            graph.add_node(value[0])
            graph.add_edge(key, value[0])

            graph.add_node(value[-1])
            graph.add_edge(value[0], value[-1])

        else:
            graph.add_node(value)
            graph.add_edge(key, value)

convert(infile, file_format) staticmethod

Convert the input file to the output file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file of the as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

The encoding of the pickle file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the data is not a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: The data as a dictionary, which can be a nested dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> Dict[str, Any]:
    """Convert the input file to the output file.

    Args:
        infile (Path): The input file of the as a path object.
        file_format (str): The encoding of the pickle file.

    Raises:
        ValueError: If the data is not a dictionary.

    Returns:
        Dict[str, Any]: The data as a dictionary, which can be a nested dictionary.
    """
    data = PklVisualizer().get_type(pkl2any(infile, encoding=file_format))
    if not isinstance(data, dict):
        raise ValueError(f"Data is not a dictionary: {data}")
    graph = PklVisualizer().create_graph(fname=infile, data_dict=data)

    pos = nx.kamada_kawai_layout(graph, scale=2)
    nx.draw_networkx_nodes(
        graph, pos, node_size=100, node_color="lightblue", alpha=0.8
    )
    nx.draw_networkx_edges(graph, pos, width=0.5, edge_color="grey", alpha=0.5)
    nx.draw_networkx_labels(graph, pos, font_size=10, font_family="sans-serif")
    plt.axis("off")
    return data

create_graph(fname, data_dict)

Create the graph.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
fname Path

The filename of the file to create the graph from.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
data_dict Dict[str, Any]

The data dictionary to create the graph from.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
DiGraph

nx.DiGraph: The graph created from the data dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def create_graph(self, fname: Path, data_dict: Dict[str, Any]) -> nx.DiGraph:
    """Create the graph.

    Args:
        fname (Path): The filename of the file to create the graph from.
        data_dict (Dict[str, Any]): The data dictionary to create the graph from.

    Returns:
        nx.DiGraph: The graph created from the data dictionary.
    """
    graph = nx.DiGraph()
    graph.add_node(str(fname.name))
    for key in data_dict:
        graph.add_edge(str(fname.name), key)

    self.add_nodes(graph=graph, data_dict=data_dict)
    return graph

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parser = argparse.ArgumentParser(
        description="Converter for 'SpectraFit' from pkl files to a graph.",
        usage="%(prog)s [options] infile",
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="Filename of the pkl file to convert to graph.",
    )
    parser.add_argument(
        "-f",
        "--file-format",
        help="File format for the optional encoding of the pickle file."
        " Default is 'latin1'.",
        type=str,
        default="latin1",
        choices=self.choices_fformat,
    )
    parser.add_argument(
        "-e",
        "--export-format",
        help="File extension for the graph export.",
        type=str,
        default="pdf",
        choices=self.choices_export,
    )

    return vars(parser.parse_args())

get_type(value)

Get the type of the value.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
value Any

The value to get the type from.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
Union[Dict[str, Any], str]

Union[Dict[str, Any], str]: The type of the value.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def get_type(self, value: Any) -> Union[Dict[str, Any], str]:
    """Get the type of the value.

    Args:
        value (Any): The value to get the type from.

    Returns:
        Union[Dict[str, Any], str]: The type of the value.
    """
    if isinstance(value, dict):
        return {key: self.get_type(value) for key, value in value.items()}
    if isinstance(value, np.ndarray):
        return f"{type(value)} of shape {value.shape}"
    return str(type(value))

save(data, fname, export_format)

Save the graph to a file and the data and their types to a json file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

The data to save, which can be a nested dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The filename of the file to save.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The file format to save the graph to.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the export format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the graph to a file and the data and their types to a json file.

    Args:
        data (Any): The data to save, which can be a nested dictionary.
        fname (Path): The filename of the file to save.
        export_format (str): The file format to save the graph to.

    Raises:
        ValueError: If the export format is not supported.
    """
    if export_format.lower() not in self.choices_export:
        raise ValueError(f"Export format '{export_format}' is not supported.")

    plt.savefig(
        pure_fname(fname).with_suffix(f".{export_format}"),
        format=export_format,
    )

    with open(pure_fname(fname).with_suffix(".json"), "w+", encoding="utf-8") as f:
        json.dump(data, f, indent=4)

command_line_runner()

Run the converter from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pkl_visualizer.py
Python
def command_line_runner() -> None:
    """Run the converter from the command line."""
    PklVisualizer()()

RIXS Converter for RIXS data

Transform the raw pkl data into a JSON, TOML, or numpy file for RIXS.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

RIXSConverter

Bases: Converter

Convert raw pickle data into JSON, TOML, or numpy formats.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
class RIXSConverter(Converter):
    """Convert raw pickle data into JSON, TOML, or numpy formats."""

    def get_args(self) -> Dict[str, Any]:
        """Retrieve command-line arguments.

        Returns:
            Dict[str, Any]: Dictionary of input file arguments.
        """
        parser = argparse.ArgumentParser(
            description="Convert 'SpectraFit' pickle files to JSON, "
            "TOML, or numpy formats for RIXS-Visualizer.",
            usage="%(prog)s [options] input_file",
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="Path to the pickle file to be converted.",
        )
        parser.add_argument(
            "-f",
            "--file-format",
            help="Encoding format of the pickle file (default: 'latin1').",
            type=str,
            default="latin1",
            choices=choices_fformat,
        )
        parser.add_argument(
            "-e",
            "--export-format",
            help="Desired export file format (default: 'json').",
            type=str,
            default="json",
            choices=choices_export,
        )
        parser.add_argument(
            "-ie",
            "--incident-energy",
            help="Label for the incident energy.",
            type=str,
        )
        parser.add_argument(
            "-ee",
            "--emission-energy",
            help="Label for the emitted energy.",
            type=str,
        )
        parser.add_argument(
            "-rm",
            "--rixs-map",
            help="Label for the RIXS map.",
            type=str,
        )
        parser.add_argument(
            "-m",
            "--mode",
            help="Post-processing mode for the RIXS map (default: 'sum').",
            type=str,
            default="sum",
            choices=choices_mode,
        )
        return vars(parser.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
        """Convert the pkl file to a dictionary.

        Args:
            infile (Path): The input file.
            file_format (str): The file format for the optional encoding of the pickle
                file.

        Returns:
            MutableMapping[str, Any]: The data dictionary from the pkl file.
        """
        data_dict = {}
        for _dict in pkl2any(infile, file_format):
            data_dict.update(_dict)
        return data_dict

    def create_rixs(
        self,
        data: MutableMapping[str, Any],
        incident_energy: str,
        emission_energy: str,
        rixs_map: str,
        mode: str,
    ) -> RIXSModelAPI:
        """Create the RIXS map from the pkl file.

        Args:
            data (MutableMapping[str, Any]): The data dictionary from the pkl file.
            incident_energy (str): The name of the incident energy.
            emission_energy (str): The name of the emitted energy.
            rixs_map (str): The name of the RIXS map.
            mode (str): The mode of the RIXS map post-processing, e.g. 'sum' or 'max'.

        Raises:
            ValueError: If the mode is not in the choices.
            KeyError: If the incident energy, emission energy, or RIXS map is not in
                the data.

        Returns:
            RIXSModelAPI: The RIXS map as a RIXSModelAPI pydantic object.
        """
        if mode not in choices_mode:
            raise ValueError(f"Mode '{mode}' not in {choices_mode}.")
        if incident_energy not in data:
            self.raise_error(incident_energy, data)
        if emission_energy not in data:
            self.raise_error(incident_energy, data)
        if rixs_map not in data:
            self.raise_error(incident_energy, data)

        if mode == "sum":
            rixs_val = np.sum(data[rixs_map], axis=0)
        elif mode == "mean":
            rixs_val = np.mean(data[rixs_map], axis=0)
        return RIXSModelAPI(
            incident_energy=data[incident_energy],
            emission_energy=data[emission_energy],
            rixs_map=rixs_val,
        )

    @staticmethod
    def raise_error(wrong_key: str, data: Any) -> None:
        """Raise an error if the key is not in the data.

        Args:
            wrong_key (str): The key which is not in the data.
            data (Any): The data dictionary from the pkl file.

        Raises:
            KeyError: If the key is not in the data.

        """
        raise KeyError(
            f"Key '{wrong_key}' not in data. Aailable keys are: {list(data.keys())}."
        )

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the data to a file.

        Args:
            data (Any): The data to save.
            fname (Path): The filename.
            export_format (str): The file extension for the export.

        Raises:
            ValueError: If the export format is not in the choices.
        """
        if export_format not in choices_export:
            raise ValueError(
                f"Export format '{export_format}' not in {choices_export}."
            )

        if export_format == "json":
            with (
                pure_fname(fname)
                .with_suffix(f".{export_format}")
                .open("w", encoding="utf-8")
            ) as f:
                json.dump(self.numpydict2listdict(data), f, indent=4)
        elif export_format in {"toml", "lock"}:
            with pure_fname(fname).with_suffix(f".{export_format}").open("wb") as f:
                tomli_w.dump(self.numpydict2listdict(data), f, multiline_strings=False)
        elif export_format == "npy":
            np.save(pure_fname(fname).with_suffix(f".{export_format}"), data)
        elif export_format == "npz":
            np.savez(pure_fname(fname).with_suffix(f".{export_format}"), **data)

    @staticmethod
    def numpydict2listdict(data: MutableMapping[str, Any]) -> MutableMapping[str, Any]:
        """Convert a dictionary with numpy arrays to a dictionary with lists.

        Args:
            data (MutableMapping[str, Any]): The data dictionary.

        Returns:
            MutableMapping[str, Any]: The data dictionary with lists.
        """
        return {k: v.tolist() for k, v in data.items()}

    def __call__(self) -> None:
        """Run the converter."""
        args = self.get_args()
        self.save(
            data=self.create_rixs(
                data=self.convert(args["infile"], args["file_format"]),
                incident_energy=args["incident_energy"],
                emission_energy=args["emission_energy"],
                rixs_map=args["rixs_map"],
                mode=args["mode"],
            ).model_dump(),
            fname=args["infile"],
            export_format=args["export_format"],
        )

__call__()

Run the converter.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
def __call__(self) -> None:
    """Run the converter."""
    args = self.get_args()
    self.save(
        data=self.create_rixs(
            data=self.convert(args["infile"], args["file_format"]),
            incident_energy=args["incident_energy"],
            emission_energy=args["emission_energy"],
            rixs_map=args["rixs_map"],
            mode=args["mode"],
        ).model_dump(),
        fname=args["infile"],
        export_format=args["export_format"],
    )

convert(infile, file_format) staticmethod

Convert the pkl file to a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

The file format for the optional encoding of the pickle file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any]: The data dictionary from the pkl file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
    """Convert the pkl file to a dictionary.

    Args:
        infile (Path): The input file.
        file_format (str): The file format for the optional encoding of the pickle
            file.

    Returns:
        MutableMapping[str, Any]: The data dictionary from the pkl file.
    """
    data_dict = {}
    for _dict in pkl2any(infile, file_format):
        data_dict.update(_dict)
    return data_dict

create_rixs(data, incident_energy, emission_energy, rixs_map, mode)

Create the RIXS map from the pkl file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data MutableMapping[str, Any]

The data dictionary from the pkl file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
incident_energy str

The name of the incident energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
emission_energy str

The name of the emitted energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
rixs_map str

The name of the RIXS map.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
mode str

The mode of the RIXS map post-processing, e.g. 'sum' or 'max'.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the mode is not in the choices.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

KeyError

If the incident energy, emission energy, or RIXS map is not in the data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Name Type Description
RIXSModelAPI RIXSModelAPI

The RIXS map as a RIXSModelAPI pydantic object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
def create_rixs(
    self,
    data: MutableMapping[str, Any],
    incident_energy: str,
    emission_energy: str,
    rixs_map: str,
    mode: str,
) -> RIXSModelAPI:
    """Create the RIXS map from the pkl file.

    Args:
        data (MutableMapping[str, Any]): The data dictionary from the pkl file.
        incident_energy (str): The name of the incident energy.
        emission_energy (str): The name of the emitted energy.
        rixs_map (str): The name of the RIXS map.
        mode (str): The mode of the RIXS map post-processing, e.g. 'sum' or 'max'.

    Raises:
        ValueError: If the mode is not in the choices.
        KeyError: If the incident energy, emission energy, or RIXS map is not in
            the data.

    Returns:
        RIXSModelAPI: The RIXS map as a RIXSModelAPI pydantic object.
    """
    if mode not in choices_mode:
        raise ValueError(f"Mode '{mode}' not in {choices_mode}.")
    if incident_energy not in data:
        self.raise_error(incident_energy, data)
    if emission_energy not in data:
        self.raise_error(incident_energy, data)
    if rixs_map not in data:
        self.raise_error(incident_energy, data)

    if mode == "sum":
        rixs_val = np.sum(data[rixs_map], axis=0)
    elif mode == "mean":
        rixs_val = np.mean(data[rixs_map], axis=0)
    return RIXSModelAPI(
        incident_energy=data[incident_energy],
        emission_energy=data[emission_energy],
        rixs_map=rixs_val,
    )

get_args()

Retrieve command-line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Dictionary of input file arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
def get_args(self) -> Dict[str, Any]:
    """Retrieve command-line arguments.

    Returns:
        Dict[str, Any]: Dictionary of input file arguments.
    """
    parser = argparse.ArgumentParser(
        description="Convert 'SpectraFit' pickle files to JSON, "
        "TOML, or numpy formats for RIXS-Visualizer.",
        usage="%(prog)s [options] input_file",
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="Path to the pickle file to be converted.",
    )
    parser.add_argument(
        "-f",
        "--file-format",
        help="Encoding format of the pickle file (default: 'latin1').",
        type=str,
        default="latin1",
        choices=choices_fformat,
    )
    parser.add_argument(
        "-e",
        "--export-format",
        help="Desired export file format (default: 'json').",
        type=str,
        default="json",
        choices=choices_export,
    )
    parser.add_argument(
        "-ie",
        "--incident-energy",
        help="Label for the incident energy.",
        type=str,
    )
    parser.add_argument(
        "-ee",
        "--emission-energy",
        help="Label for the emitted energy.",
        type=str,
    )
    parser.add_argument(
        "-rm",
        "--rixs-map",
        help="Label for the RIXS map.",
        type=str,
    )
    parser.add_argument(
        "-m",
        "--mode",
        help="Post-processing mode for the RIXS map (default: 'sum').",
        type=str,
        default="sum",
        choices=choices_mode,
    )
    return vars(parser.parse_args())

numpydict2listdict(data) staticmethod

Convert a dictionary with numpy arrays to a dictionary with lists.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data MutableMapping[str, Any]

The data dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any]: The data dictionary with lists.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
@staticmethod
def numpydict2listdict(data: MutableMapping[str, Any]) -> MutableMapping[str, Any]:
    """Convert a dictionary with numpy arrays to a dictionary with lists.

    Args:
        data (MutableMapping[str, Any]): The data dictionary.

    Returns:
        MutableMapping[str, Any]: The data dictionary with lists.
    """
    return {k: v.tolist() for k, v in data.items()}

raise_error(wrong_key, data) staticmethod

Raise an error if the key is not in the data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
wrong_key str

The key which is not in the data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
data Any

The data dictionary from the pkl file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
KeyError

If the key is not in the data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
@staticmethod
def raise_error(wrong_key: str, data: Any) -> None:
    """Raise an error if the key is not in the data.

    Args:
        wrong_key (str): The key which is not in the data.
        data (Any): The data dictionary from the pkl file.

    Raises:
        KeyError: If the key is not in the data.

    """
    raise KeyError(
        f"Key '{wrong_key}' not in data. Aailable keys are: {list(data.keys())}."
    )

save(data, fname, export_format)

Save the data to a file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
data Any

The data to save.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The filename.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
export_format str

The file extension for the export.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the export format is not in the choices.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the data to a file.

    Args:
        data (Any): The data to save.
        fname (Path): The filename.
        export_format (str): The file extension for the export.

    Raises:
        ValueError: If the export format is not in the choices.
    """
    if export_format not in choices_export:
        raise ValueError(
            f"Export format '{export_format}' not in {choices_export}."
        )

    if export_format == "json":
        with (
            pure_fname(fname)
            .with_suffix(f".{export_format}")
            .open("w", encoding="utf-8")
        ) as f:
            json.dump(self.numpydict2listdict(data), f, indent=4)
    elif export_format in {"toml", "lock"}:
        with pure_fname(fname).with_suffix(f".{export_format}").open("wb") as f:
            tomli_w.dump(self.numpydict2listdict(data), f, multiline_strings=False)
    elif export_format == "npy":
        np.save(pure_fname(fname).with_suffix(f".{export_format}"), data)
    elif export_format == "npz":
        np.savez(pure_fname(fname).with_suffix(f".{export_format}"), **data)

command_line_runner()

Run the command line script.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_converter.py
Python
def command_line_runner() -> None:
    """Run the command line script."""
    RIXSConverter()()

On top of the RIXSConverter class, the RIXSVisualizer class is available to visualize the RIXS data and provide a method to take RIXS cuts.

This module contains the RIXS visualizer class.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

RIXSApp

Bases: RIXSFigure

Create the RIXS app.

About the RIXS app

The RIXS app is a web application that allows you to visualize the RIXS data. The app is based on the Dash framework. The app is composed of three figures: the RIXS figure, the XES figure and the XAS figure.

The RIXS figure is a 3D surface plot. The XES figure is a line plot showing the XES spectrum. The XAS figure is a line plot showing the XAS spectrum.

The RIXS figure is interactive. You can zoom in and out, rotate the figure, and change the color scale. The XES and XAS figures are not interactive.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
class RIXSApp(RIXSFigure):  # pragma: no cover
    """Create the RIXS app.

    !!! info "About the RIXS app"

        The RIXS app is a web application that allows you to visualize the RIXS
        data. The app is based on the Dash framework. The app is composed of
        three figures: the RIXS figure, the XES figure and the XAS figure.

        The RIXS figure is a 3D surface plot. The XES figure is a line plot
        showing the XES spectrum. The XAS figure is a line plot showing the XAS
        spectrum.

        The RIXS figure is interactive. You can zoom in and out, rotate the
        figure, and change the color scale. The XES and XAS figures are not
        interactive.

    """

    def __init__(
        self,
        incident_energy: NDArray[np.float64],
        emission_energy: NDArray[np.float64],
        rixs_map: NDArray[np.float64],
        size: SizeRatioAPI = SizeRatioAPI(
            size=(500, 500),
            ratio_rixs=(2, 2),
            ratio_xas=(3, 1),
            ratio_xes=(3, 1),
        ),
        main_title: MainTitleAPI = MainTitleAPI(rixs="RIXS", xes="XES", xas="XAS"),
        fdir: Path = Path("./"),
        mode: str = "server",
        jupyter_dash: bool = False,
        port: int = 8050,
        debug: bool = False,
    ) -> None:
        """Create the RIXS app.

        Args:
            incident_energy (NDArray[np.float64]): Incident energy.
            emission_energy (NDArray[np.float64]): Emission energy.
            rixs_map (NDArray[np.float64]): RIXS data as a 2D array.
            size (SizeRatioAPI, optional): Size of the figures. Defaults to
                 SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xas=(3, 1),
                 ratio_xes=(3, 1)).
            main_title (MainTitleAPI, optional): Main title of the figures.
                 Defaults to MainTitleAPI(rixs="RIXS", xes="XES", xas="XAS").
            fdir (Path, optional): Directory to save the figures. Defaults to
                 Path("./").
            mode (str, optional): Mode of the app. Defaults to "server".
            port (int, optional): Port of the app. Defaults to 8050.
            jupyter_dash (bool, optional): Jupyter Dash mode. Defaults to False.
            debug (bool, optional): Debug mode. Defaults to False.

        """
        super().__init__(
            incident_energy=incident_energy,
            emission_energy=emission_energy,
            rixs_map=rixs_map,
            size=size,
        )
        self.fdir = fdir
        self.main_title = main_title
        self.mode = mode
        self.jupyter_dash = jupyter_dash
        self.port = port
        self.debug = debug
        if not self.debug:
            self.logging_flask()

    def logging_flask(self) -> None:
        """Set the logging level of the Flask server to ERROR."""
        log = logging.getLogger("werkzeug")
        log.setLevel(logging.ERROR)

    def colorscale(self) -> html.Div:
        """Create the color scale dropdown.

        Returns:
            html.Div: Color scale dropdown.
        """
        return html.Div(
            [
                dbc.Label("Color Scale"),
                dcc.Dropdown(
                    id="colorscale",
                    options=[
                        {"label": "Viridis", "value": "Viridis"},
                        {"label": "Plasma", "value": "Plasma"},
                        {"label": "Inferno", "value": "Inferno"},
                        {"label": "Magma", "value": "Magma"},
                        {"label": "Cividis", "value": "Cividis"},
                        {"label": "Greys", "value": "Greys"},
                        {"label": "Greens", "value": "Greens"},
                        {"label": "YlOrRd", "value": "YlOrRd"},
                        {"label": "Bluered", "value": "Bluered"},
                        {"label": "RdBu", "value": "RdBu"},
                        {"label": "Reds", "value": "Reds"},
                        {"label": "Blues", "value": "Blues"},
                        {"label": "Picnic", "value": "Picnic"},
                        {"label": "Rainbow", "value": "Rainbow"},
                        {"label": "Portland", "value": "Portland"},
                        {"label": "Jet", "value": "Jet"},
                        {"label": "Hot", "value": "Hot"},
                        {"label": "Blackbody", "value": "Blackbody"},
                        {"label": "Earth", "value": "Earth"},
                        {"label": "Electric", "value": "Electric"},
                        {"label": "Viridis", "value": "Viridis"},
                        {"label": "Cividis", "value": "Cividis"},
                    ],
                    value="Viridis",
                ),
            ],
            className="dbc",
        )

    def opacity(self) -> html.Div:
        """Create the opacity slider.

        Returns:
            html.Div: Opacity slider.
        """
        return html.Div(
            [
                dbc.Label("Opacity"),
                dcc.Slider(
                    id="opacity",
                    min=0,
                    max=1,
                    step=0.1,
                    value=1,
                    marks={i: str(i) for i in range(2)},
                ),
            ]
        )

    def header(self) -> dbc.Card:
        """Create the header.

        Returns:
            dbc.Card: Header as a bootstrap card.
        """
        return dbc.Card(
            dbc.CardBody(
                [
                    html.H4(
                        "RIXS Visualizer App",
                        className="bg-primary text-white p-2 mb-2 text-center",
                    )
                ]
            )
        )

    def pre_body(self) -> Tuple[html.Div, html.Div, html.Div]:
        """Create the body.

        Returns:
            Tuple[html.Div, html.Div, html.Div]: Body as a tuple of three plot parts.
        """
        rixs = html.Div(
            [
                dbc.Label(self.main_title.rixs),
                dcc.Graph(id="rixs-figure"),
            ]
        )
        xes = html.Div(
            [
                dbc.Label(self.main_title.xes),
                dcc.Graph(id="xes-figure"),
            ]
        )
        xas = html.Div(
            [
                dbc.Label(self.main_title.xas),
                dcc.Graph(id="xas-figure"),
            ]
        )
        return rixs, xes, xas

    def body(self) -> dbc.Card:
        """Create the body.

        Returns:
            dbc.Card: Body as a bootstrap card.
        """
        colorscale = self.colorscale()
        opacity = self.opacity()
        rixs, xes, xas = self.pre_body()

        return (
            dbc.Card(
                dbc.CardBody(
                    [
                        dbc.Row([ThemeChangerAIO(aio_id="theme")]),
                        dbc.Row(
                            [
                                dbc.Col(
                                    html.H1("RIXS Viewer", className="text-center")
                                ),
                            ],
                            justify="left",
                        ),
                        html.Br(),
                        dbc.Row(
                            [
                                dbc.Col(colorscale),
                                dbc.Col(opacity),
                            ],
                        ),
                        html.Br(),
                        dbc.Row(
                            [
                                dbc.Col(rixs),
                                dbc.Col([xes, xas]),
                            ],
                            justify="left",
                        ),
                        html.Br(),
                    ],
                ),
                class_name="mt-4",
            ),
        )[0]

    def footer(self) -> dbc.Card:
        """Create the footer.

        Returns:
            dbc.Card: Footer as a bootstrap card.
        """
        return (
            dbc.Card(
                dbc.CardBody(
                    [
                        dbc.Row(
                            [
                                dcc.Markdown(
                                    """
                    ### RIXS Viewer
                    This is a simple RIXS viewer. It is based on the
                    [Dash](https://dash.plotly.com/)
                    framework and uses the [Plotly](https://plotly.com/python/) library
                    for plotting. The code is available on
                    [GitHub](https://github.com/anselmoo/spectrafit).
                    """
                                ),
                            ],
                            justify="left",
                        )
                    ]
                ),
                class_name="mt-4",
            ),
        )[0]

    def app_run(self) -> None:
        """Run the app."""
        dbc_css = (
            "https://cdn.jsdelivr.net/gh/AnnMarieW/dash-bootstrap-templates/dbc.min.css"
        )
        external_stylesheets = [dbc.themes.COSMO, dbc_css]
        if self.jupyter_dash:
            app = JupyterDash(__name__, external_stylesheets=external_stylesheets)
        else:
            app = dash.Dash(
                __name__,
                external_stylesheets=external_stylesheets,
                meta_tags=[
                    {
                        "name": "viewport",
                        "content": "width=device-width, initial-scale=1",
                    }
                ],
            )
        app.layout = dbc.Container(
            [
                self.header(),
                self.body(),
                self.footer(),
            ],
            fluid=True,
        )

        @app.callback(
            [
                dash.dependencies.Output("xes-figure", "figure"),
                dash.dependencies.Output("xas-figure", "figure"),
                dash.dependencies.Output("rixs-figure", "figure"),
            ],
            [
                dash.dependencies.Input("rixs-figure", "hoverData"),
                dash.dependencies.Input("rixs-figure", "clickData"),
                dash.dependencies.Input("colorscale", "value"),
                dash.dependencies.Input("opacity", "value"),
                dash.dependencies.Input(ThemeChangerAIO.ids.radio("theme"), "value"),
            ],
        )
        def update_hover_data(
            hoverData: Dict[str, List[Dict[str, float]]],
            clickData: Dict[str, List[Dict[str, float]]],
            colorscale: str,
            opacity: float,
            theme: str,
        ) -> Tuple[go.Figure, go.Figure, go.Figure]:
            if hoverData is None:
                return (
                    self.create_xas(
                        x=self.incident_energy,
                        y=self.rixs_map[:, int(self.emission_energy.size / 2)],
                        template=template_from_url(theme),
                    ),
                    self.create_xes(
                        x=self.emission_energy,
                        y=self.rixs_map[int(self.incident_energy.size / 2), :],
                        template=template_from_url(theme),
                    ),
                    self.create_rixs(
                        colorscale=colorscale,
                        opacity=opacity,
                        template=template_from_url(theme),
                    ),
                )
            x = hoverData["points"][0]["x"]
            y = hoverData["points"][0]["y"]
            xes_fig = self.create_xas(
                x=self.incident_energy,
                y=self.rixs_map[:, int(x)],
                template=template_from_url(theme),
            )
            xas_fig = self.create_xes(
                x=self.emission_energy,
                y=self.rixs_map[int(y), :],
                template=template_from_url(theme),
            )
            rixs_fig = self.create_rixs(
                colorscale=colorscale,
                opacity=opacity,
                template=template_from_url(theme),
            )
            if clickData is None:
                return xes_fig, xas_fig, rixs_fig
            cx = clickData["points"][0]["x"]
            cy = clickData["points"][0]["y"]
            pd.DataFrame(
                {"energy": self.emission_energy, "intensity": self.rixs_map[int(cy), :]}
            ).to_csv(
                self.fdir / f"xes_cut_{np.round(cx, 8)}.txt",
                index=False,
            )
            pd.DataFrame(
                {"energy": self.incident_energy, "intensity": self.rixs_map[:, int(cx)]}
            ).to_csv(
                self.fdir / f"xas_cut_{np.round(cy, 8)}.txt",
                index=False,
            )
            return xes_fig, xas_fig, rixs_fig

        if self.jupyter_dash:
            app.run_server(mode=self.mode, debug=self.debug, port=self.port)
        else:
            app.run_server(debug=self.debug, port=self.port)

__init__(incident_energy, emission_energy, rixs_map, size=SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xas=(3, 1), ratio_xes=(3, 1)), main_title=MainTitleAPI(rixs='RIXS', xes='XES', xas='XAS'), fdir=Path('./'), mode='server', jupyter_dash=False, port=8050, debug=False)

Create the RIXS app.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
incident_energy NDArray[float64]

Incident energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
emission_energy NDArray[float64]

Emission energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
rixs_map NDArray[float64]

RIXS data as a 2D array.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
size SizeRatioAPI

Size of the figures. Defaults to SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xas=(3, 1), ratio_xes=(3, 1)).

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xas=(3, 1), ratio_xes=(3, 1))
main_title MainTitleAPI

Main title of the figures. Defaults to MainTitleAPI(rixs="RIXS", xes="XES", xas="XAS").

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

MainTitleAPI(rixs='RIXS', xes='XES', xas='XAS')
fdir Path

Directory to save the figures. Defaults to Path("./").

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Path('./')
mode str

Mode of the app. Defaults to "server".

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

'server'
port int

Port of the app. Defaults to 8050.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

8050
jupyter_dash bool

Jupyter Dash mode. Defaults to False.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

False
debug bool

Debug mode. Defaults to False.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

False
Source code in spectrafit/plugins/rixs_visualizer.py
Python
def __init__(
    self,
    incident_energy: NDArray[np.float64],
    emission_energy: NDArray[np.float64],
    rixs_map: NDArray[np.float64],
    size: SizeRatioAPI = SizeRatioAPI(
        size=(500, 500),
        ratio_rixs=(2, 2),
        ratio_xas=(3, 1),
        ratio_xes=(3, 1),
    ),
    main_title: MainTitleAPI = MainTitleAPI(rixs="RIXS", xes="XES", xas="XAS"),
    fdir: Path = Path("./"),
    mode: str = "server",
    jupyter_dash: bool = False,
    port: int = 8050,
    debug: bool = False,
) -> None:
    """Create the RIXS app.

    Args:
        incident_energy (NDArray[np.float64]): Incident energy.
        emission_energy (NDArray[np.float64]): Emission energy.
        rixs_map (NDArray[np.float64]): RIXS data as a 2D array.
        size (SizeRatioAPI, optional): Size of the figures. Defaults to
             SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xas=(3, 1),
             ratio_xes=(3, 1)).
        main_title (MainTitleAPI, optional): Main title of the figures.
             Defaults to MainTitleAPI(rixs="RIXS", xes="XES", xas="XAS").
        fdir (Path, optional): Directory to save the figures. Defaults to
             Path("./").
        mode (str, optional): Mode of the app. Defaults to "server".
        port (int, optional): Port of the app. Defaults to 8050.
        jupyter_dash (bool, optional): Jupyter Dash mode. Defaults to False.
        debug (bool, optional): Debug mode. Defaults to False.

    """
    super().__init__(
        incident_energy=incident_energy,
        emission_energy=emission_energy,
        rixs_map=rixs_map,
        size=size,
    )
    self.fdir = fdir
    self.main_title = main_title
    self.mode = mode
    self.jupyter_dash = jupyter_dash
    self.port = port
    self.debug = debug
    if not self.debug:
        self.logging_flask()

app_run()

Run the app.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def app_run(self) -> None:
    """Run the app."""
    dbc_css = (
        "https://cdn.jsdelivr.net/gh/AnnMarieW/dash-bootstrap-templates/dbc.min.css"
    )
    external_stylesheets = [dbc.themes.COSMO, dbc_css]
    if self.jupyter_dash:
        app = JupyterDash(__name__, external_stylesheets=external_stylesheets)
    else:
        app = dash.Dash(
            __name__,
            external_stylesheets=external_stylesheets,
            meta_tags=[
                {
                    "name": "viewport",
                    "content": "width=device-width, initial-scale=1",
                }
            ],
        )
    app.layout = dbc.Container(
        [
            self.header(),
            self.body(),
            self.footer(),
        ],
        fluid=True,
    )

    @app.callback(
        [
            dash.dependencies.Output("xes-figure", "figure"),
            dash.dependencies.Output("xas-figure", "figure"),
            dash.dependencies.Output("rixs-figure", "figure"),
        ],
        [
            dash.dependencies.Input("rixs-figure", "hoverData"),
            dash.dependencies.Input("rixs-figure", "clickData"),
            dash.dependencies.Input("colorscale", "value"),
            dash.dependencies.Input("opacity", "value"),
            dash.dependencies.Input(ThemeChangerAIO.ids.radio("theme"), "value"),
        ],
    )
    def update_hover_data(
        hoverData: Dict[str, List[Dict[str, float]]],
        clickData: Dict[str, List[Dict[str, float]]],
        colorscale: str,
        opacity: float,
        theme: str,
    ) -> Tuple[go.Figure, go.Figure, go.Figure]:
        if hoverData is None:
            return (
                self.create_xas(
                    x=self.incident_energy,
                    y=self.rixs_map[:, int(self.emission_energy.size / 2)],
                    template=template_from_url(theme),
                ),
                self.create_xes(
                    x=self.emission_energy,
                    y=self.rixs_map[int(self.incident_energy.size / 2), :],
                    template=template_from_url(theme),
                ),
                self.create_rixs(
                    colorscale=colorscale,
                    opacity=opacity,
                    template=template_from_url(theme),
                ),
            )
        x = hoverData["points"][0]["x"]
        y = hoverData["points"][0]["y"]
        xes_fig = self.create_xas(
            x=self.incident_energy,
            y=self.rixs_map[:, int(x)],
            template=template_from_url(theme),
        )
        xas_fig = self.create_xes(
            x=self.emission_energy,
            y=self.rixs_map[int(y), :],
            template=template_from_url(theme),
        )
        rixs_fig = self.create_rixs(
            colorscale=colorscale,
            opacity=opacity,
            template=template_from_url(theme),
        )
        if clickData is None:
            return xes_fig, xas_fig, rixs_fig
        cx = clickData["points"][0]["x"]
        cy = clickData["points"][0]["y"]
        pd.DataFrame(
            {"energy": self.emission_energy, "intensity": self.rixs_map[int(cy), :]}
        ).to_csv(
            self.fdir / f"xes_cut_{np.round(cx, 8)}.txt",
            index=False,
        )
        pd.DataFrame(
            {"energy": self.incident_energy, "intensity": self.rixs_map[:, int(cx)]}
        ).to_csv(
            self.fdir / f"xas_cut_{np.round(cy, 8)}.txt",
            index=False,
        )
        return xes_fig, xas_fig, rixs_fig

    if self.jupyter_dash:
        app.run_server(mode=self.mode, debug=self.debug, port=self.port)
    else:
        app.run_server(debug=self.debug, port=self.port)

body()

Create the body.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Card

dbc.Card: Body as a bootstrap card.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def body(self) -> dbc.Card:
    """Create the body.

    Returns:
        dbc.Card: Body as a bootstrap card.
    """
    colorscale = self.colorscale()
    opacity = self.opacity()
    rixs, xes, xas = self.pre_body()

    return (
        dbc.Card(
            dbc.CardBody(
                [
                    dbc.Row([ThemeChangerAIO(aio_id="theme")]),
                    dbc.Row(
                        [
                            dbc.Col(
                                html.H1("RIXS Viewer", className="text-center")
                            ),
                        ],
                        justify="left",
                    ),
                    html.Br(),
                    dbc.Row(
                        [
                            dbc.Col(colorscale),
                            dbc.Col(opacity),
                        ],
                    ),
                    html.Br(),
                    dbc.Row(
                        [
                            dbc.Col(rixs),
                            dbc.Col([xes, xas]),
                        ],
                        justify="left",
                    ),
                    html.Br(),
                ],
            ),
            class_name="mt-4",
        ),
    )[0]

colorscale()

Create the color scale dropdown.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Div

html.Div: Color scale dropdown.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def colorscale(self) -> html.Div:
    """Create the color scale dropdown.

    Returns:
        html.Div: Color scale dropdown.
    """
    return html.Div(
        [
            dbc.Label("Color Scale"),
            dcc.Dropdown(
                id="colorscale",
                options=[
                    {"label": "Viridis", "value": "Viridis"},
                    {"label": "Plasma", "value": "Plasma"},
                    {"label": "Inferno", "value": "Inferno"},
                    {"label": "Magma", "value": "Magma"},
                    {"label": "Cividis", "value": "Cividis"},
                    {"label": "Greys", "value": "Greys"},
                    {"label": "Greens", "value": "Greens"},
                    {"label": "YlOrRd", "value": "YlOrRd"},
                    {"label": "Bluered", "value": "Bluered"},
                    {"label": "RdBu", "value": "RdBu"},
                    {"label": "Reds", "value": "Reds"},
                    {"label": "Blues", "value": "Blues"},
                    {"label": "Picnic", "value": "Picnic"},
                    {"label": "Rainbow", "value": "Rainbow"},
                    {"label": "Portland", "value": "Portland"},
                    {"label": "Jet", "value": "Jet"},
                    {"label": "Hot", "value": "Hot"},
                    {"label": "Blackbody", "value": "Blackbody"},
                    {"label": "Earth", "value": "Earth"},
                    {"label": "Electric", "value": "Electric"},
                    {"label": "Viridis", "value": "Viridis"},
                    {"label": "Cividis", "value": "Cividis"},
                ],
                value="Viridis",
            ),
        ],
        className="dbc",
    )

footer()

Create the footer.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Card

dbc.Card: Footer as a bootstrap card.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def footer(self) -> dbc.Card:
    """Create the footer.

    Returns:
        dbc.Card: Footer as a bootstrap card.
    """
    return (
        dbc.Card(
            dbc.CardBody(
                [
                    dbc.Row(
                        [
                            dcc.Markdown(
                                """
                ### RIXS Viewer
                This is a simple RIXS viewer. It is based on the
                [Dash](https://dash.plotly.com/)
                framework and uses the [Plotly](https://plotly.com/python/) library
                for plotting. The code is available on
                [GitHub](https://github.com/anselmoo/spectrafit).
                """
                            ),
                        ],
                        justify="left",
                    )
                ]
            ),
            class_name="mt-4",
        ),
    )[0]

header()

Create the header.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Card

dbc.Card: Header as a bootstrap card.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def header(self) -> dbc.Card:
    """Create the header.

    Returns:
        dbc.Card: Header as a bootstrap card.
    """
    return dbc.Card(
        dbc.CardBody(
            [
                html.H4(
                    "RIXS Visualizer App",
                    className="bg-primary text-white p-2 mb-2 text-center",
                )
            ]
        )
    )

logging_flask()

Set the logging level of the Flask server to ERROR.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def logging_flask(self) -> None:
    """Set the logging level of the Flask server to ERROR."""
    log = logging.getLogger("werkzeug")
    log.setLevel(logging.ERROR)

opacity()

Create the opacity slider.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Div

html.Div: Opacity slider.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def opacity(self) -> html.Div:
    """Create the opacity slider.

    Returns:
        html.Div: Opacity slider.
    """
    return html.Div(
        [
            dbc.Label("Opacity"),
            dcc.Slider(
                id="opacity",
                min=0,
                max=1,
                step=0.1,
                value=1,
                marks={i: str(i) for i in range(2)},
            ),
        ]
    )

pre_body()

Create the body.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Tuple[Div, Div, Div]

Tuple[html.Div, html.Div, html.Div]: Body as a tuple of three plot parts.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def pre_body(self) -> Tuple[html.Div, html.Div, html.Div]:
    """Create the body.

    Returns:
        Tuple[html.Div, html.Div, html.Div]: Body as a tuple of three plot parts.
    """
    rixs = html.Div(
        [
            dbc.Label(self.main_title.rixs),
            dcc.Graph(id="rixs-figure"),
        ]
    )
    xes = html.Div(
        [
            dbc.Label(self.main_title.xes),
            dcc.Graph(id="xes-figure"),
        ]
    )
    xas = html.Div(
        [
            dbc.Label(self.main_title.xas),
            dcc.Graph(id="xas-figure"),
        ]
    )
    return rixs, xes, xas

RIXSFigure

Class to create the RIXS figure.

About the RIXS figure

The RIXS figure is composed of three subplots:

  • RIXS -> 3D plot
  • XES -> 2D plot
  • XAS -> 2D plot

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
class RIXSFigure:
    """Class to create the RIXS figure.

    !!! info "About the RIXS figure"

        The RIXS figure is composed of three subplots:

        - RIXS -> 3D plot
        - XES -> 2D plot
        - XAS -> 2D plot

    """

    def __init__(
        self,
        incident_energy: NDArray[np.float64],
        emission_energy: NDArray[np.float64],
        rixs_map: NDArray[np.float64],
        size: SizeRatioAPI = SizeRatioAPI(
            size=(500, 500),
            ratio_rixs=(2, 2),
            ratio_xes=(3, 1),
            ratio_xas=(3, 1),
        ),
        x_axis: XAxisAPI = XAxisAPI(name="Incident Energy", unit="eV"),
        y_axis: YAxisAPI = YAxisAPI(name="Emission Energy", unit="eV"),
        z_axis: ZAxisAPI = ZAxisAPI(name="Intensity", unit="a.u."),
    ):
        """Initialize the RIXS figure.

        Args:
            incident_energy (NDArray[np.float64]): Incident energy.
            emission_energy (NDArray[np.float64]): Emission energy.
            rixs_map (NDArray[np.float64]): RIXS data as a 2D array.
            size (SizeRatioAPI, optional): Size of the figure.
                 Defaults to SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2),
                 ratio_xes=(3, 1), ratio_xas=(3, 1)).
            x_axis (XAxisAPI, optional): X-Axis of the figure.
                 Defaults to XAxisAPI(name="Incident Energy", unit="eV").
            y_axis (YAxisAPI, optional): Y-Axis of the figure.
                 Defaults to YAxisAPI(name="Emission Energy", unit="eV").
            z_axis (ZAxisAPI, optional): Z-Axis of the figure.
                 Defaults to ZAxisAPI(name="Intensity", unit="a.u.").
        """
        self.incident_energy = incident_energy
        self.emission_energy = emission_energy
        self.rixs_map = rixs_map

        self.x_axis = x_axis
        self.y_axis = y_axis
        self.z_axis = z_axis
        self.initialize_figure_size(size)

    def initialize_figure_size(self, size: SizeRatioAPI) -> None:
        """Initialize the size of the figure.

        Args:
            size (SizeRatioAPI): Size of the figure.
        """
        self.rixs_width = int(size.size[0] * size.ratio_rixs[0])
        self.rixs_height = int(size.size[1] * size.ratio_rixs[1])
        self.xas_width = int(size.size[0] * size.ratio_xas[0])
        self.xas_height = int(size.size[1] * size.ratio_xas[1])
        self.xes_width = int(size.size[0] * size.ratio_xes[0])
        self.xes_height = int(size.size[1] * size.ratio_xes[1])

    def create_rixs(
        self,
        colorscale: str = "Viridis",
        opacity: float = 0.9,
        template: Optional[str] = None,
    ) -> go.Figure:
        """Create the RIXS figure.

        Args:
            colorscale (str, optional): Color scale. Defaults to "Viridis".
            opacity (float, optional): Opacity of the surface. Defaults to 0.9.
            template (str, optional): Template of the figure. Defaults to None.

        Returns:
            go.Figure: RIXS figure.
        """
        fig = go.Figure(
            data=[
                go.Surface(
                    x=self.incident_energy,
                    y=self.emission_energy,
                    z=self.rixs_map,
                    colorscale=colorscale,
                    opacity=opacity,
                    contours_z=dict(
                        show=True,
                        usecolormap=True,
                        highlightcolor="limegreen",
                        project_z=True,
                    ),
                )
            ],
        )

        fig.update_layout(
            autosize=True,
            width=self.rixs_width,
            height=self.rixs_height,
            scene=dict(
                xaxis_title=DataFramePlot.title_text(
                    name=self.x_axis.name, unit=self.x_axis.unit
                ),
                yaxis_title=DataFramePlot.title_text(
                    name=self.y_axis.name, unit=self.y_axis.unit
                ),
                zaxis_title=DataFramePlot.title_text(
                    name=self.z_axis.name, unit=self.z_axis.unit
                ),
                aspectmode="cube",
            ),
            template=template,
        )
        fig.update_traces(
            contours_z=dict(
                show=True, usecolormap=True, highlightcolor="limegreen", project_z=True
            )
        )
        return fig

    def create_xes(
        self,
        x: NDArray[np.float64],
        y: NDArray[np.float64],
        template: Optional[str] = None,
    ) -> go.Figure:
        """Create the XES figure.

        Args:
            x (NDArray[np.float64]): X-axis of the figure.
            y (NDArray[np.float64]): Y-axis of the figure.
            template (str, optional): Template of the figure. Defaults to None.

        Returns:
            go.Figure: XES figure.
        """
        fig = px.line(x=x, y=y, template=template)
        fig.update_layout(
            autosize=True,
            width=self.xes_width,
            height=self.xes_height,
        )
        # Udate the xaxis title
        fig.update_xaxes(
            title_text=DataFramePlot.title_text(
                name=self.y_axis.name, unit=self.y_axis.unit
            )
        )
        # Update the yaxis title
        fig.update_yaxes(
            title_text=DataFramePlot.title_text(
                name=self.z_axis.name, unit=self.z_axis.unit
            )
        )
        return fig

    def create_xas(
        self,
        x: NDArray[np.float64],
        y: NDArray[np.float64],
        template: Optional[str] = None,
    ) -> go.Figure:
        """Create the XAS figure.

        Args:
            x (NDArray[np.float64]): X-axis of the figure.
            y (NDArray[np.float64]): Y-axis of the figure.
            template (str, optional): Template of the figure. Defaults to None.

        Returns:
            go.Figure: XAS figure.
        """
        fig = px.line(x=x, y=y, template=template)
        fig.update_layout(
            autosize=True,
            width=self.xas_width,
            height=self.xas_height,
        )
        fig.update_xaxes(
            title_text=DataFramePlot.title_text(
                name=self.x_axis.name, unit=self.x_axis.unit
            )
        )
        fig.update_yaxes(
            title_text=DataFramePlot.title_text(
                name=self.z_axis.name, unit=self.z_axis.unit
            )
        )
        return fig

__init__(incident_energy, emission_energy, rixs_map, size=SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xes=(3, 1), ratio_xas=(3, 1)), x_axis=XAxisAPI(name='Incident Energy', unit='eV'), y_axis=YAxisAPI(name='Emission Energy', unit='eV'), z_axis=ZAxisAPI(name='Intensity', unit='a.u.'))

Initialize the RIXS figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
incident_energy NDArray[float64]

Incident energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
emission_energy NDArray[float64]

Emission energy.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
rixs_map NDArray[float64]

RIXS data as a 2D array.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
size SizeRatioAPI

Size of the figure. Defaults to SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xes=(3, 1), ratio_xas=(3, 1)).

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2), ratio_xes=(3, 1), ratio_xas=(3, 1))
x_axis XAxisAPI

X-Axis of the figure. Defaults to XAxisAPI(name="Incident Energy", unit="eV").

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

XAxisAPI(name='Incident Energy', unit='eV')
y_axis YAxisAPI

Y-Axis of the figure. Defaults to YAxisAPI(name="Emission Energy", unit="eV").

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

YAxisAPI(name='Emission Energy', unit='eV')
z_axis ZAxisAPI

Z-Axis of the figure. Defaults to ZAxisAPI(name="Intensity", unit="a.u.").

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

ZAxisAPI(name='Intensity', unit='a.u.')
Source code in spectrafit/plugins/rixs_visualizer.py
Python
def __init__(
    self,
    incident_energy: NDArray[np.float64],
    emission_energy: NDArray[np.float64],
    rixs_map: NDArray[np.float64],
    size: SizeRatioAPI = SizeRatioAPI(
        size=(500, 500),
        ratio_rixs=(2, 2),
        ratio_xes=(3, 1),
        ratio_xas=(3, 1),
    ),
    x_axis: XAxisAPI = XAxisAPI(name="Incident Energy", unit="eV"),
    y_axis: YAxisAPI = YAxisAPI(name="Emission Energy", unit="eV"),
    z_axis: ZAxisAPI = ZAxisAPI(name="Intensity", unit="a.u."),
):
    """Initialize the RIXS figure.

    Args:
        incident_energy (NDArray[np.float64]): Incident energy.
        emission_energy (NDArray[np.float64]): Emission energy.
        rixs_map (NDArray[np.float64]): RIXS data as a 2D array.
        size (SizeRatioAPI, optional): Size of the figure.
             Defaults to SizeRatioAPI(size=(500, 500), ratio_rixs=(2, 2),
             ratio_xes=(3, 1), ratio_xas=(3, 1)).
        x_axis (XAxisAPI, optional): X-Axis of the figure.
             Defaults to XAxisAPI(name="Incident Energy", unit="eV").
        y_axis (YAxisAPI, optional): Y-Axis of the figure.
             Defaults to YAxisAPI(name="Emission Energy", unit="eV").
        z_axis (ZAxisAPI, optional): Z-Axis of the figure.
             Defaults to ZAxisAPI(name="Intensity", unit="a.u.").
    """
    self.incident_energy = incident_energy
    self.emission_energy = emission_energy
    self.rixs_map = rixs_map

    self.x_axis = x_axis
    self.y_axis = y_axis
    self.z_axis = z_axis
    self.initialize_figure_size(size)

create_rixs(colorscale='Viridis', opacity=0.9, template=None)

Create the RIXS figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
colorscale str

Color scale. Defaults to "Viridis".

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

'Viridis'
opacity float

Opacity of the surface. Defaults to 0.9.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

0.9
template str

Template of the figure. Defaults to None.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

None

Returns:

Type Description
Figure

go.Figure: RIXS figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def create_rixs(
    self,
    colorscale: str = "Viridis",
    opacity: float = 0.9,
    template: Optional[str] = None,
) -> go.Figure:
    """Create the RIXS figure.

    Args:
        colorscale (str, optional): Color scale. Defaults to "Viridis".
        opacity (float, optional): Opacity of the surface. Defaults to 0.9.
        template (str, optional): Template of the figure. Defaults to None.

    Returns:
        go.Figure: RIXS figure.
    """
    fig = go.Figure(
        data=[
            go.Surface(
                x=self.incident_energy,
                y=self.emission_energy,
                z=self.rixs_map,
                colorscale=colorscale,
                opacity=opacity,
                contours_z=dict(
                    show=True,
                    usecolormap=True,
                    highlightcolor="limegreen",
                    project_z=True,
                ),
            )
        ],
    )

    fig.update_layout(
        autosize=True,
        width=self.rixs_width,
        height=self.rixs_height,
        scene=dict(
            xaxis_title=DataFramePlot.title_text(
                name=self.x_axis.name, unit=self.x_axis.unit
            ),
            yaxis_title=DataFramePlot.title_text(
                name=self.y_axis.name, unit=self.y_axis.unit
            ),
            zaxis_title=DataFramePlot.title_text(
                name=self.z_axis.name, unit=self.z_axis.unit
            ),
            aspectmode="cube",
        ),
        template=template,
    )
    fig.update_traces(
        contours_z=dict(
            show=True, usecolormap=True, highlightcolor="limegreen", project_z=True
        )
    )
    return fig

create_xas(x, y, template=None)

Create the XAS figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
x NDArray[float64]

X-axis of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
y NDArray[float64]

Y-axis of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
template str

Template of the figure. Defaults to None.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

None

Returns:

Type Description
Figure

go.Figure: XAS figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def create_xas(
    self,
    x: NDArray[np.float64],
    y: NDArray[np.float64],
    template: Optional[str] = None,
) -> go.Figure:
    """Create the XAS figure.

    Args:
        x (NDArray[np.float64]): X-axis of the figure.
        y (NDArray[np.float64]): Y-axis of the figure.
        template (str, optional): Template of the figure. Defaults to None.

    Returns:
        go.Figure: XAS figure.
    """
    fig = px.line(x=x, y=y, template=template)
    fig.update_layout(
        autosize=True,
        width=self.xas_width,
        height=self.xas_height,
    )
    fig.update_xaxes(
        title_text=DataFramePlot.title_text(
            name=self.x_axis.name, unit=self.x_axis.unit
        )
    )
    fig.update_yaxes(
        title_text=DataFramePlot.title_text(
            name=self.z_axis.name, unit=self.z_axis.unit
        )
    )
    return fig

create_xes(x, y, template=None)

Create the XES figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
x NDArray[float64]

X-axis of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
y NDArray[float64]

Y-axis of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
template str

Template of the figure. Defaults to None.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

None

Returns:

Type Description
Figure

go.Figure: XES figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def create_xes(
    self,
    x: NDArray[np.float64],
    y: NDArray[np.float64],
    template: Optional[str] = None,
) -> go.Figure:
    """Create the XES figure.

    Args:
        x (NDArray[np.float64]): X-axis of the figure.
        y (NDArray[np.float64]): Y-axis of the figure.
        template (str, optional): Template of the figure. Defaults to None.

    Returns:
        go.Figure: XES figure.
    """
    fig = px.line(x=x, y=y, template=template)
    fig.update_layout(
        autosize=True,
        width=self.xes_width,
        height=self.xes_height,
    )
    # Udate the xaxis title
    fig.update_xaxes(
        title_text=DataFramePlot.title_text(
            name=self.y_axis.name, unit=self.y_axis.unit
        )
    )
    # Update the yaxis title
    fig.update_yaxes(
        title_text=DataFramePlot.title_text(
            name=self.z_axis.name, unit=self.z_axis.unit
        )
    )
    return fig

initialize_figure_size(size)

Initialize the size of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
size SizeRatioAPI

Size of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/rixs_visualizer.py
Python
def initialize_figure_size(self, size: SizeRatioAPI) -> None:
    """Initialize the size of the figure.

    Args:
        size (SizeRatioAPI): Size of the figure.
    """
    self.rixs_width = int(size.size[0] * size.ratio_rixs[0])
    self.rixs_height = int(size.size[1] * size.ratio_rixs[1])
    self.xas_width = int(size.size[0] * size.ratio_xas[0])
    self.xas_height = int(size.size[1] * size.ratio_xas[1])
    self.xes_width = int(size.size[0] * size.ratio_xes[0])
    self.xes_height = int(size.size[1] * size.ratio_xes[1])

RIXSVisualizer

RIXS Visualizer. This class is used to visualize RIXS data.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
class RIXSVisualizer:
    """RIXS Visualizer. This class is used to visualize RIXS data."""

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parser = argparse.ArgumentParser(
            description="`RIXS-Visualizer` is a simple RIXS plane viewer, which "
            "allows to visualize RIXS data in a 2D plane."
        )
        parser.add_argument(
            "infile",
            type=Path,
            help="The input file. This can be a json, toml, npy, or npz file.",
        )
        return vars(parser.parse_args())

    @staticmethod
    def load_data(infile: Path) -> RIXSModelAPI:
        """Load the data from the input file.

        Args:
            infile (Path): The input file path. This can be a json, toml, npy, or npz
                file.

        Raises:
            ValueError: If the file type is not supported.

        Returns:
            RIXSModelAPI: The data as a pydantic model object with the following
                attributes: incident_energy, emission_energy, and rixs_map. The
                incident_energy and emission_energy are 1D arrays, and the rixs_map is
                a 2D array.
        """
        if infile.suffix == ".npy":
            data = np.load(infile, allow_pickle=True).item()
        elif infile.suffix == ".npz":
            data = np.load(infile, allow_pickle=True)
        elif infile.suffix == ".json":
            with infile.open(encoding="utf-8") as f:
                data = json.load(f)
        elif infile.suffix in {".toml", ".lock"}:
            with infile.open("rb") as f:
                data = tomli.load(f)
        else:
            raise ValueError(f"File type {infile.suffix} is not supported.")
        return RIXSModelAPI(
            incident_energy=np.array(data["incident_energy"]),
            emission_energy=np.array(data["emission_energy"]),
            rixs_map=np.array(data["rixs_map"]),
        )

    def __call__(self) -> None:  # pragma: no cover
        """Run the RIXS Visualizer."""
        app = RIXSApp(**self.load_data(self.get_args()["infile"]).model_dump())
        app.app_run()

__call__()

Run the RIXS Visualizer.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def __call__(self) -> None:  # pragma: no cover
    """Run the RIXS Visualizer."""
    app = RIXSApp(**self.load_data(self.get_args()["infile"]).model_dump())
    app.app_run()

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parser = argparse.ArgumentParser(
        description="`RIXS-Visualizer` is a simple RIXS plane viewer, which "
        "allows to visualize RIXS data in a 2D plane."
    )
    parser.add_argument(
        "infile",
        type=Path,
        help="The input file. This can be a json, toml, npy, or npz file.",
    )
    return vars(parser.parse_args())

load_data(infile) staticmethod

Load the data from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file path. This can be a json, toml, npy, or npz file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the file type is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Name Type Description
RIXSModelAPI RIXSModelAPI

The data as a pydantic model object with the following attributes: incident_energy, emission_energy, and rixs_map. The incident_energy and emission_energy are 1D arrays, and the rixs_map is a 2D array.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
@staticmethod
def load_data(infile: Path) -> RIXSModelAPI:
    """Load the data from the input file.

    Args:
        infile (Path): The input file path. This can be a json, toml, npy, or npz
            file.

    Raises:
        ValueError: If the file type is not supported.

    Returns:
        RIXSModelAPI: The data as a pydantic model object with the following
            attributes: incident_energy, emission_energy, and rixs_map. The
            incident_energy and emission_energy are 1D arrays, and the rixs_map is
            a 2D array.
    """
    if infile.suffix == ".npy":
        data = np.load(infile, allow_pickle=True).item()
    elif infile.suffix == ".npz":
        data = np.load(infile, allow_pickle=True)
    elif infile.suffix == ".json":
        with infile.open(encoding="utf-8") as f:
            data = json.load(f)
    elif infile.suffix in {".toml", ".lock"}:
        with infile.open("rb") as f:
            data = tomli.load(f)
    else:
        raise ValueError(f"File type {infile.suffix} is not supported.")
    return RIXSModelAPI(
        incident_energy=np.array(data["incident_energy"]),
        emission_energy=np.array(data["emission_energy"]),
        rixs_map=np.array(data["rixs_map"]),
    )

command_line_runner()

Run the RIXS Visualizer from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/rixs_visualizer.py
Python
def command_line_runner() -> None:
    """Run the RIXS Visualizer from the command line."""
    RIXSVisualizer()()

PPTX Converter for PowerPoint files

About the PPTX Converter

The PPTXConverter class is a work in progress and is subject to change. Especially, the layout of the PowerPoint file is not yet finalized.

Convert the lock file to a powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

PPTXConverter

Bases: Converter

Generate a powerpoint presentation from a the spectrafit output.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Attributes:

Name Type Description
pixel_size Dict[str, Dict[str, int]]

The pixel size of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
class PPTXConverter(Converter):
    """Generate a powerpoint presentation from a the spectrafit output.

    Attributes:
        pixel_size (Dict[str, Dict[str, int]]): The pixel size of the powerpoint
            presentation.
    """

    pixel_size = PPTXLayoutAPI.pptx_formats.keys()

    def get_args(self) -> Dict[str, Any]:
        """Get the arguments from the command line.

        Returns:
            Dict[str, Any]: Return the input file arguments as a dictionary without
                additional information beyond the command line arguments.
        """
        parse = argparse.ArgumentParser(
            description="Converter for 'SpectraFit' from *.lock output to a "
            "PowerPoint presentation.",
            usage="%(prog)s [options] infile",
        )
        parse.add_argument(
            "infile",
            type=Path,
            help="Filename of the *.lock file to convert to a powerpoint presentation.",
        )
        parse.add_argument(
            "-f",
            "--file-format",
            help="File format of the PowerPoint presentation. Default is '16:9'.",
            type=str,
            default="16:9",
            choices=self.pixel_size,
        )
        return vars(parse.parse_args())

    @staticmethod
    def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
        """Convert the lock file to a powerpoint presentation.

        Args:
            infile (Path): The input file of the as a path object.
            file_format (str): The powerpoint presentation file format.

        Raises:
            ValueError: If the file format is not supported.
            ValueError: If the input file is not a `*.lock` file.

        Returns:
            MutableMapping[str, Any]: The converted file as a dictionary.
        """
        if file_format not in PPTXConverter.pixel_size:
            raise ValueError(
                f"File format '{file_format}' is not supported;"
                f"it must be one of {PPTXConverter.pixel_size}"
            )

        if infile.suffix != ".lock":
            raise ValueError(
                f"File format '{infile.suffix}' is not supported; it must be '.lock'"
            )

        with infile.open("rb") as f:
            data = PPTXDataAPI(**tomli.load(f))

        return {file_format: data}

    def save(self, data: Any, fname: Path, export_format: str) -> None:
        """Save the powerpoint presentation."""
        pptx_layout = PPTXLayoutAPI(
            export_format, data=data[export_format]
        ).get_pptx_layout()

        PPTXLayout(
            ratio=pptx_layout.ratio,
            structure=pptx_layout.structure,
            fname=Path(f"{fname.stem}_{export_format.replace(':', '_')}.pptx"),
        )()

    def __call__(self) -> None:
        """Convert the lock file to a powerpoint presentation."""
        args = self.get_args()
        data = self.convert(args["infile"], args["file_format"])
        self.save(data, args["infile"], args["file_format"])

__call__()

Convert the lock file to a powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def __call__(self) -> None:
    """Convert the lock file to a powerpoint presentation."""
    args = self.get_args()
    data = self.convert(args["infile"], args["file_format"])
    self.save(data, args["infile"], args["file_format"])

convert(infile, file_format) staticmethod

Convert the lock file to a powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
infile Path

The input file of the as a path object.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
file_format str

The powerpoint presentation file format.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required

Raises:

Type Description
ValueError

If the file format is not supported.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

ValueError

If the input file is not a *.lock file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
MutableMapping[str, Any]

MutableMapping[str, Any]: The converted file as a dictionary.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
@staticmethod
def convert(infile: Path, file_format: str) -> MutableMapping[str, Any]:
    """Convert the lock file to a powerpoint presentation.

    Args:
        infile (Path): The input file of the as a path object.
        file_format (str): The powerpoint presentation file format.

    Raises:
        ValueError: If the file format is not supported.
        ValueError: If the input file is not a `*.lock` file.

    Returns:
        MutableMapping[str, Any]: The converted file as a dictionary.
    """
    if file_format not in PPTXConverter.pixel_size:
        raise ValueError(
            f"File format '{file_format}' is not supported;"
            f"it must be one of {PPTXConverter.pixel_size}"
        )

    if infile.suffix != ".lock":
        raise ValueError(
            f"File format '{infile.suffix}' is not supported; it must be '.lock'"
        )

    with infile.open("rb") as f:
        data = PPTXDataAPI(**tomli.load(f))

    return {file_format: data}

get_args()

Get the arguments from the command line.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Returns:

Type Description
Dict[str, Any]

Dict[str, Any]: Return the input file arguments as a dictionary without additional information beyond the command line arguments.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def get_args(self) -> Dict[str, Any]:
    """Get the arguments from the command line.

    Returns:
        Dict[str, Any]: Return the input file arguments as a dictionary without
            additional information beyond the command line arguments.
    """
    parse = argparse.ArgumentParser(
        description="Converter for 'SpectraFit' from *.lock output to a "
        "PowerPoint presentation.",
        usage="%(prog)s [options] infile",
    )
    parse.add_argument(
        "infile",
        type=Path,
        help="Filename of the *.lock file to convert to a powerpoint presentation.",
    )
    parse.add_argument(
        "-f",
        "--file-format",
        help="File format of the PowerPoint presentation. Default is '16:9'.",
        type=str,
        default="16:9",
        choices=self.pixel_size,
    )
    return vars(parse.parse_args())

save(data, fname, export_format)

Save the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def save(self, data: Any, fname: Path, export_format: str) -> None:
    """Save the powerpoint presentation."""
    pptx_layout = PPTXLayoutAPI(
        export_format, data=data[export_format]
    ).get_pptx_layout()

    PPTXLayout(
        ratio=pptx_layout.ratio,
        structure=pptx_layout.structure,
        fname=Path(f"{fname.stem}_{export_format.replace(':', '_')}.pptx"),
    )()

PPTXElements

Generate a powerpoint presentation from a the spectrafit output.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
class PPTXElements:
    """Generate a powerpoint presentation from a the spectrafit output."""

    def __init__(self, slide: Type[Any]) -> None:
        """Create a powerpoint presentation from a the spectrafit output.

        Args:
            slide (type): The slide of the powerpoint presentation.
        """
        self.slide = slide

    def create_textbox(
        self,
        text: str,
        position: PPTXPositionAPI,
        font_size: Pt = Pt(16),
    ) -> None:
        """Create a textbox from the input file.

        Args:
            text (str): The text of the textbox.
            position (PPTXPositionAPI): The position of the textbox in the powerpoint
                presentation.
            font_size (Pt): The font size of the textbox. Defaults to Pt(16).
        """
        tx_box = self.slide.shapes.add_textbox(
            left=position.left,
            top=position.top,
            width=position.width,
            height=position.height,
        )

        tf = tx_box.text_frame
        tf.text = text
        tf.size = font_size

    def create_figure(
        self,
        fname: Path,
        position_figure: PPTXPositionAPI,
        position_textbox: PPTXPositionAPI,
        text: str,
        font_size: Pt,
    ) -> None:
        """Create a figure from the input file.

        Args:
            fname (Path): The temporay filename of the figure.
            position_figure (PPTXPositionAPI): The position of the figure in the
                powerpoint presentation.
            position_textbox (PPTXPositionAPI): The position of the textbox in the
                powerpoint presentation.
            text (str): The text of the textbox.
            font_size (Pt): The font size of the textbox.
        """
        self.slide.shapes.add_picture(
            str(fname),
            left=position_figure.left,
            top=position_figure.top,
            width=position_figure.width,
            height=position_figure.height,
        )
        self.create_textbox(
            text=text,
            position=position_textbox,
            font_size=font_size,
        )

    def create_table(
        self,
        df: pd.DataFrame,
        position_table: PPTXPositionAPI,
        transpose: bool,
        index_hidden: bool,
        text: str,
        position_textbox: PPTXPositionAPI,
        font_size: Pt = Pt(12),
    ) -> None:
        """Create a table from the input file.

        Args:
            df (pd.DataFrame): The data of the table.
                powerpoint presentation.
            position_table (PPTXPositionAPI): The position of the table in the
                powerpoint presentation.
            transpose (bool): Transpose the table for row-like presentation in
                powerpoint presentation.
            index_hidden (bool): Hide the index of the table in the powerpoint
                presentation.
            text (str): The text of the table legend.
            position_textbox (PPTXPositionAPI): The position of the textbox in the
                powerpoint presentation.
            font_size (Pt, optional): The font size of the table. Defaults to Pt(12).
        """
        df = df.round(2)
        if transpose:
            df = df.transpose()
        self.extract_table(
            df=df, position_table=position_table, index_hidden=index_hidden
        )

        self.create_textbox(
            text=text,
            position=PPTXPositionAPI(
                left=position_textbox.left,
                top=position_textbox.top,
                width=position_textbox.width,
                height=position_textbox.height,
            ),
            font_size=font_size,
        )

    def extract_table(
        self,
        df: pd.DataFrame,
        position_table: PPTXPositionAPI,
        index_hidden: bool,
    ) -> None:
        """Create a table from the input file.

        Args:
            df (pd.DataFrame): The data of the table(s) in the powerpoint presentation.
            position_table (PPTXPositionAPI): The position of the table in the
                powerpoint presentation.
            index_hidden (bool): Hide the index of the table in the powerpoint
                presentation.
        """
        rows, cols = df.shape
        table = self.slide.shapes.add_table(
            rows=rows + 1,
            cols=cols + (not index_hidden),
            left=position_table.left,
            top=position_table.top,
            width=position_table.width,
            height=position_table.height,
        )
        table.table.cell(0, 0).text = ""
        if index_hidden:
            for i, col in enumerate(df.columns):
                table.table.cell(0, i).text = str(col)
                for j, value in enumerate(df[col]):
                    table.table.cell(j + 1, i).text = str(value)
        else:
            for i, index in enumerate(df.index, start=1):
                table.table.cell(i, 0).text = str(index)
            for i, col in enumerate(df.columns, start=1):
                table.table.cell(0, i).text = col
                for j, value in enumerate(df[col]):
                    table.table.cell(j + 1, i).text = str(value)

    def create_credit(
        self,
        fname: Path,
        text: str,
        position_logo: PPTXPositionAPI,
        position_text: PPTXPositionAPI,
        font_size: Pt = Pt(14),
    ) -> None:
        """Create a credit for spectrafit.

        Args:
            fname (Path): The temporay filename of the figure.
            text (str): The text of the credit.
            position_logo (PPTXPositionAPI): The position of the logo in the powerpoint
                presentation.
            position_text (PPTXPositionAPI): The position of the text in the powerpoint
                presentation.
            font_size (Pt): The font size of the textbox. Defaults to Pt(14).
        """
        self.create_figure(
            fname=fname,
            position_figure=position_logo,
            text=text,
            position_textbox=position_text,
            font_size=font_size,
        )

    def create_title(self, text: str, position: PPTXPositionAPI) -> None:
        """Create a title from the input file.

        Args:
            text (str): The text of the title.
            position (PPTXPositionAPI): The position of the title in the powerpoint
                presentation.
        """
        title = self.slide.shapes.title
        title.text = text
        title.left = position.left
        title.top = position.top
        title.width = position.width
        title.height = position.height

    def create_subtitle(self, text: str, position: PPTXPositionAPI, index: int) -> None:
        """Create a subtitle from the input file.

        Args:
            text (str): The text of the subtitle.
            position (PPTXPositionAPI): The position of the subtitle in the powerpoint
                presentation.
            index (int): The index of the subtitle in the powerpoint presentation.
        """
        subtitle = self.slide.placeholders[index]
        subtitle.text = text
        subtitle.left = position.left
        subtitle.top = position.top
        subtitle.width = position.width
        subtitle.height = position.height

__init__(slide)

Create a powerpoint presentation from a the spectrafit output.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
slide type

The slide of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def __init__(self, slide: Type[Any]) -> None:
    """Create a powerpoint presentation from a the spectrafit output.

    Args:
        slide (type): The slide of the powerpoint presentation.
    """
    self.slide = slide

create_credit(fname, text, position_logo, position_text, font_size=Pt(14))

Create a credit for spectrafit.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
fname Path

The temporay filename of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
text str

The text of the credit.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_logo PPTXPositionAPI

The position of the logo in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_text PPTXPositionAPI

The position of the text in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
font_size Pt

The font size of the textbox. Defaults to Pt(14).

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Pt(14)
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_credit(
    self,
    fname: Path,
    text: str,
    position_logo: PPTXPositionAPI,
    position_text: PPTXPositionAPI,
    font_size: Pt = Pt(14),
) -> None:
    """Create a credit for spectrafit.

    Args:
        fname (Path): The temporay filename of the figure.
        text (str): The text of the credit.
        position_logo (PPTXPositionAPI): The position of the logo in the powerpoint
            presentation.
        position_text (PPTXPositionAPI): The position of the text in the powerpoint
            presentation.
        font_size (Pt): The font size of the textbox. Defaults to Pt(14).
    """
    self.create_figure(
        fname=fname,
        position_figure=position_logo,
        text=text,
        position_textbox=position_text,
        font_size=font_size,
    )

create_figure(fname, position_figure, position_textbox, text, font_size)

Create a figure from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
fname Path

The temporay filename of the figure.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_figure PPTXPositionAPI

The position of the figure in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_textbox PPTXPositionAPI

The position of the textbox in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
text str

The text of the textbox.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
font_size Pt

The font size of the textbox.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_figure(
    self,
    fname: Path,
    position_figure: PPTXPositionAPI,
    position_textbox: PPTXPositionAPI,
    text: str,
    font_size: Pt,
) -> None:
    """Create a figure from the input file.

    Args:
        fname (Path): The temporay filename of the figure.
        position_figure (PPTXPositionAPI): The position of the figure in the
            powerpoint presentation.
        position_textbox (PPTXPositionAPI): The position of the textbox in the
            powerpoint presentation.
        text (str): The text of the textbox.
        font_size (Pt): The font size of the textbox.
    """
    self.slide.shapes.add_picture(
        str(fname),
        left=position_figure.left,
        top=position_figure.top,
        width=position_figure.width,
        height=position_figure.height,
    )
    self.create_textbox(
        text=text,
        position=position_textbox,
        font_size=font_size,
    )

create_subtitle(text, position, index)

Create a subtitle from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
text str

The text of the subtitle.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position PPTXPositionAPI

The position of the subtitle in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
index int

The index of the subtitle in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_subtitle(self, text: str, position: PPTXPositionAPI, index: int) -> None:
    """Create a subtitle from the input file.

    Args:
        text (str): The text of the subtitle.
        position (PPTXPositionAPI): The position of the subtitle in the powerpoint
            presentation.
        index (int): The index of the subtitle in the powerpoint presentation.
    """
    subtitle = self.slide.placeholders[index]
    subtitle.text = text
    subtitle.left = position.left
    subtitle.top = position.top
    subtitle.width = position.width
    subtitle.height = position.height

create_table(df, position_table, transpose, index_hidden, text, position_textbox, font_size=Pt(12))

Create a table from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
df DataFrame

The data of the table. powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_table PPTXPositionAPI

The position of the table in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
transpose bool

Transpose the table for row-like presentation in powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
index_hidden bool

Hide the index of the table in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
text str

The text of the table legend.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_textbox PPTXPositionAPI

The position of the textbox in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
font_size Pt

The font size of the table. Defaults to Pt(12).

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Pt(12)
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_table(
    self,
    df: pd.DataFrame,
    position_table: PPTXPositionAPI,
    transpose: bool,
    index_hidden: bool,
    text: str,
    position_textbox: PPTXPositionAPI,
    font_size: Pt = Pt(12),
) -> None:
    """Create a table from the input file.

    Args:
        df (pd.DataFrame): The data of the table.
            powerpoint presentation.
        position_table (PPTXPositionAPI): The position of the table in the
            powerpoint presentation.
        transpose (bool): Transpose the table for row-like presentation in
            powerpoint presentation.
        index_hidden (bool): Hide the index of the table in the powerpoint
            presentation.
        text (str): The text of the table legend.
        position_textbox (PPTXPositionAPI): The position of the textbox in the
            powerpoint presentation.
        font_size (Pt, optional): The font size of the table. Defaults to Pt(12).
    """
    df = df.round(2)
    if transpose:
        df = df.transpose()
    self.extract_table(
        df=df, position_table=position_table, index_hidden=index_hidden
    )

    self.create_textbox(
        text=text,
        position=PPTXPositionAPI(
            left=position_textbox.left,
            top=position_textbox.top,
            width=position_textbox.width,
            height=position_textbox.height,
        ),
        font_size=font_size,
    )

create_textbox(text, position, font_size=Pt(16))

Create a textbox from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
text str

The text of the textbox.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position PPTXPositionAPI

The position of the textbox in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
font_size Pt

The font size of the textbox. Defaults to Pt(16).

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Pt(16)
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_textbox(
    self,
    text: str,
    position: PPTXPositionAPI,
    font_size: Pt = Pt(16),
) -> None:
    """Create a textbox from the input file.

    Args:
        text (str): The text of the textbox.
        position (PPTXPositionAPI): The position of the textbox in the powerpoint
            presentation.
        font_size (Pt): The font size of the textbox. Defaults to Pt(16).
    """
    tx_box = self.slide.shapes.add_textbox(
        left=position.left,
        top=position.top,
        width=position.width,
        height=position.height,
    )

    tf = tx_box.text_frame
    tf.text = text
    tf.size = font_size

create_title(text, position)

Create a title from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
text str

The text of the title.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position PPTXPositionAPI

The position of the title in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def create_title(self, text: str, position: PPTXPositionAPI) -> None:
    """Create a title from the input file.

    Args:
        text (str): The text of the title.
        position (PPTXPositionAPI): The position of the title in the powerpoint
            presentation.
    """
    title = self.slide.shapes.title
    title.text = text
    title.left = position.left
    title.top = position.top
    title.width = position.width
    title.height = position.height

extract_table(df, position_table, index_hidden)

Create a table from the input file.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
df DataFrame

The data of the table(s) in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
position_table PPTXPositionAPI

The position of the table in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
index_hidden bool

Hide the index of the table in the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def extract_table(
    self,
    df: pd.DataFrame,
    position_table: PPTXPositionAPI,
    index_hidden: bool,
) -> None:
    """Create a table from the input file.

    Args:
        df (pd.DataFrame): The data of the table(s) in the powerpoint presentation.
        position_table (PPTXPositionAPI): The position of the table in the
            powerpoint presentation.
        index_hidden (bool): Hide the index of the table in the powerpoint
            presentation.
    """
    rows, cols = df.shape
    table = self.slide.shapes.add_table(
        rows=rows + 1,
        cols=cols + (not index_hidden),
        left=position_table.left,
        top=position_table.top,
        width=position_table.width,
        height=position_table.height,
    )
    table.table.cell(0, 0).text = ""
    if index_hidden:
        for i, col in enumerate(df.columns):
            table.table.cell(0, i).text = str(col)
            for j, value in enumerate(df[col]):
                table.table.cell(j + 1, i).text = str(value)
    else:
        for i, index in enumerate(df.index, start=1):
            table.table.cell(i, 0).text = str(index)
        for i, col in enumerate(df.columns, start=1):
            table.table.cell(0, i).text = col
            for j, value in enumerate(df[col]):
                table.table.cell(j + 1, i).text = str(value)

PPTXLayout

Bases: PPTXElements

Generate a powerpoint presentation from a the spectrafit output.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
class PPTXLayout(PPTXElements):
    """Generate a powerpoint presentation from a the spectrafit output."""

    def __init__(
        self, ratio: PPTXRatioAPI, structure: PPTXStructureAPI, fname: Path
    ) -> None:
        """Create a powerpoint presentation from a the spectrafit output.

        Args:
            ratio (PPTXRatioAPI): The ratio of the powerpoint presentation.
            structure (PPTXStructureAPI): The structure of the powerpoint presentation.
            fname (Path): The temporay filename of the powerpoint presentation.
        """
        self.ratio = ratio
        self.structure = structure
        self.fname = fname

        self._initialiaze()
        super().__init__(self.slide)

    def _initialiaze(self) -> None:
        """Initialize the powerpoint presentation."""
        self.prs = Presentation()
        self.prs.slide_width = self.ratio.width
        self.prs.slide_height = self.ratio.height
        self.slide = self.prs.slides.add_slide(self.prs.slide_layouts[3])

    def top_element(self) -> None:
        """Create the top element of the powerpoint presentation."""
        self.create_title(
            text=self.structure.header.text, position=self.structure.header.position
        )

    def lefr_element(self) -> None:
        """Create the left element of the powerpoint presentation."""
        self.create_subtitle(
            text=self.structure.sub_title_left.text,
            position=self.structure.sub_title_left.position,
            index=self.structure.sub_title_left.index,
        )
        self.create_figure(
            fname=self.structure.sub_title_left.figure.fname,
            position_figure=self.structure.sub_title_left.figure.position,
            text=self.structure.sub_title_left.figure.description.text,
            position_textbox=self.structure.sub_title_left.figure.description.position,
            font_size=self.structure.sub_title_left.figure.description.font_size,
        )

    def right_element(self) -> None:
        """Create the right element of the powerpoint presentation."""
        self.create_subtitle(
            text=self.structure.sub_title_right.text,
            position=self.structure.sub_title_right.position,
            index=self.structure.sub_title_right.index,
        )
        self.create_table(
            df=self.structure.sub_title_right.table_1.df,
            position_table=self.structure.sub_title_right.table_1.position,
            transpose=self.structure.sub_title_right.table_1.transpose,
            index_hidden=self.structure.sub_title_right.table_1.index_hidden,
            text=self.structure.sub_title_right.table_1.description.text,
            position_textbox=(
                self.structure.sub_title_right.table_1.description.position
            ),
            font_size=self.structure.sub_title_right.table_1.description.font_size,
        )
        self.create_table(
            df=self.structure.sub_title_right.table_2.df,
            position_table=self.structure.sub_title_right.table_2.position,
            transpose=self.structure.sub_title_right.table_2.transpose,
            index_hidden=self.structure.sub_title_right.table_2.index_hidden,
            text=self.structure.sub_title_right.table_2.description.text,
            position_textbox=(
                self.structure.sub_title_right.table_2.description.position
            ),
            font_size=self.structure.sub_title_right.table_2.description.font_size,
        )
        self.create_table(
            df=self.structure.sub_title_right.table_3.df,
            position_table=self.structure.sub_title_right.table_3.position,
            transpose=self.structure.sub_title_right.table_3.transpose,
            index_hidden=self.structure.sub_title_right.table_3.index_hidden,
            text=self.structure.sub_title_right.table_3.description.text,
            position_textbox=(
                self.structure.sub_title_right.table_3.description.position
            ),
            font_size=self.structure.sub_title_right.table_3.description.font_size,
        )
        self.create_credit(
            fname=self.structure.sub_title_right.credit.fname,
            text=self.structure.sub_title_right.credit.description.text,
            position_logo=self.structure.sub_title_right.credit.position,
            position_text=self.structure.sub_title_right.credit.description.position,
            font_size=self.structure.sub_title_right.credit.description.font_size,
        )

    def save(self) -> None:
        """Save the powerpoint presentation."""
        self.prs.save(str(self.fname))

    def __call__(self) -> None:
        """Create the powerpoint presentation."""
        self.top_element()
        self.lefr_element()
        self.right_element()
        self.save()

__call__()

Create the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def __call__(self) -> None:
    """Create the powerpoint presentation."""
    self.top_element()
    self.lefr_element()
    self.right_element()
    self.save()

__init__(ratio, structure, fname)

Create a powerpoint presentation from a the spectrafit output.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Parameters:

Name Type Description Default
ratio PPTXRatioAPI

The ratio of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
structure PPTXStructureAPI

The structure of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
fname Path

The temporay filename of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

required
Source code in spectrafit/plugins/pptx_converter.py
Python
def __init__(
    self, ratio: PPTXRatioAPI, structure: PPTXStructureAPI, fname: Path
) -> None:
    """Create a powerpoint presentation from a the spectrafit output.

    Args:
        ratio (PPTXRatioAPI): The ratio of the powerpoint presentation.
        structure (PPTXStructureAPI): The structure of the powerpoint presentation.
        fname (Path): The temporay filename of the powerpoint presentation.
    """
    self.ratio = ratio
    self.structure = structure
    self.fname = fname

    self._initialiaze()
    super().__init__(self.slide)

lefr_element()

Create the left element of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def lefr_element(self) -> None:
    """Create the left element of the powerpoint presentation."""
    self.create_subtitle(
        text=self.structure.sub_title_left.text,
        position=self.structure.sub_title_left.position,
        index=self.structure.sub_title_left.index,
    )
    self.create_figure(
        fname=self.structure.sub_title_left.figure.fname,
        position_figure=self.structure.sub_title_left.figure.position,
        text=self.structure.sub_title_left.figure.description.text,
        position_textbox=self.structure.sub_title_left.figure.description.position,
        font_size=self.structure.sub_title_left.figure.description.font_size,
    )

right_element()

Create the right element of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def right_element(self) -> None:
    """Create the right element of the powerpoint presentation."""
    self.create_subtitle(
        text=self.structure.sub_title_right.text,
        position=self.structure.sub_title_right.position,
        index=self.structure.sub_title_right.index,
    )
    self.create_table(
        df=self.structure.sub_title_right.table_1.df,
        position_table=self.structure.sub_title_right.table_1.position,
        transpose=self.structure.sub_title_right.table_1.transpose,
        index_hidden=self.structure.sub_title_right.table_1.index_hidden,
        text=self.structure.sub_title_right.table_1.description.text,
        position_textbox=(
            self.structure.sub_title_right.table_1.description.position
        ),
        font_size=self.structure.sub_title_right.table_1.description.font_size,
    )
    self.create_table(
        df=self.structure.sub_title_right.table_2.df,
        position_table=self.structure.sub_title_right.table_2.position,
        transpose=self.structure.sub_title_right.table_2.transpose,
        index_hidden=self.structure.sub_title_right.table_2.index_hidden,
        text=self.structure.sub_title_right.table_2.description.text,
        position_textbox=(
            self.structure.sub_title_right.table_2.description.position
        ),
        font_size=self.structure.sub_title_right.table_2.description.font_size,
    )
    self.create_table(
        df=self.structure.sub_title_right.table_3.df,
        position_table=self.structure.sub_title_right.table_3.position,
        transpose=self.structure.sub_title_right.table_3.transpose,
        index_hidden=self.structure.sub_title_right.table_3.index_hidden,
        text=self.structure.sub_title_right.table_3.description.text,
        position_textbox=(
            self.structure.sub_title_right.table_3.description.position
        ),
        font_size=self.structure.sub_title_right.table_3.description.font_size,
    )
    self.create_credit(
        fname=self.structure.sub_title_right.credit.fname,
        text=self.structure.sub_title_right.credit.description.text,
        position_logo=self.structure.sub_title_right.credit.position,
        position_text=self.structure.sub_title_right.credit.description.position,
        font_size=self.structure.sub_title_right.credit.description.font_size,
    )

save()

Save the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def save(self) -> None:
    """Save the powerpoint presentation."""
    self.prs.save(str(self.fname))

top_element()

Create the top element of the powerpoint presentation.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def top_element(self) -> None:
    """Create the top element of the powerpoint presentation."""
    self.create_title(
        text=self.structure.header.text, position=self.structure.header.position
    )

command_line_runner()

Command line interface for the converter plugin.

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting

Source code in spectrafit/plugins/pptx_converter.py
Python
def command_line_runner() -> None:
    """Command line interface for the converter plugin."""
    PPTXConverter()()

_[API]: Application Programming Interface _[ASCII]: American Standard Code for Information Interchange; a common plain text format _[Amplitude]: The height or maximum value of a peak function _[Athena]: Interactive graphical utility for XAS analysis based on IFEFFIT or LARCH _[Automatic Peak Detection]: Automatically finding peaks in the data using algorithms like find_peaks _[Background Subtraction]: Removing the underlying signal or baseline from the raw data _[Baseline]: The underlying signal or background upon which spectral features are superimposed _[Baseline Correction]: The process of estimating and removing the baseline signal _[Bayesian Inference]: Statistical method used for updating probabilities based on evidence, applicable in parameter estimation _[Bounds]: The lower and upper limits constraining a Parameter during optimization _[Calibration]: Process of correlating the readings of an instrument with a standard to ensure accuracy, e.g., energy calibration _[Center]: The position of the maximum of a peak function along the independent variable axis (e.g., energy, wavenumber) _[CI/CD]: Continuous Integration/Continuous Deployment _[CLI]: Command Line Interface _[CSV]: Comma-Separated Values file format _[Chi-squared (χ²)]: A statistical measure of the Goodness-of-fit between observed data and a Model _[Confidence Intervals]: A range of values providing an estimate of the uncertainty of a fitted Parameter _[Configuration File]: A file containing settings and parameters for software, often in formats like JSON, YAML, or TOML _[Convergence]: The state reached when an iterative optimization algorithm finds a stable solution where further iterations do not significantly improve the fit _[Conventional Commits]: A specification for adding human and machine readable meaning to commit messages _[Convolution]: A mathematical operation combining two functions to produce a third function, expressing how the shape of one is modified by the other; relevant for Voigt profiles _[Correlation]: A statistical measure indicating the extent to which two fitted Parameters move in relation to each other _[Covariance Matrix]: A matrix whose elements represent the covariances between pairs of fitted Parameters, used to estimate uncertainties _[Curve Fitting]: The process of constructing a curve, or mathematical function, that has the best fit to a series of data points _[Data Acquisition]: The process of collecting data from an experiment or instrument _[Data Model API]: Application programming interface that allows interaction with the data model defined using Pydantic _[Deconvolution]: Process of resolving overlapping peaks or removing instrumental broadening effects _[Degrees of Freedom (DoF)]: The number of independent pieces of information available to estimate another quantity; typically number of data points minus number of varied parameters _[Derivative]: The rate of change of a function; used in spectroscopy for peak finding or enhancing features _[Detector]: Device used to measure the intensity of radiation in spectroscopic experiments _[Dictionaries]: Collection of key-value pairs in Python _[Diffraction]: The bending of waves as they pass around an obstacle or through an aperture, relevant in X-ray techniques _[Docker]: Platform for developing, shipping, and running applications in containers _[Emission]: Process by which a substance releases energy in the form of electromagnetic radiation _[Energy]: Physical quantity often used as the independent variable (x-axis) in spectroscopic measurements (e.g., eV, keV) _[Environment (Virtual)]: Isolated Python environment managing dependencies for a specific project (e.g., using venv, Conda, Poetry) _[Excel]: Spreadsheet software developed by Microsoft _[Expressions]: Mathematical constraints or dependencies between different fitting Parameters, evaluated by lmfit _[Fluorescence]: Emission of light by a substance that has absorbed light or other electromagnetic radiation _[Fourier Transform]: Mathematical transform used to decompose a function into its constituent frequencies, used in FT-IR spectroscopy _[Frequency]: Number of occurrences of a repeating event per unit of time, related to energy and wavelength _[FWHM]: Full Width at Half Maximum; a measure of the width of a peak function (e.g., fwhmg, fwhml) _[Gaussian]: A common bell-shaped peak function used in curve fitting _[Git]: Distributed version control system _[GitHub]: Platform for hosting Git repositories and collaboration _[GUI]: Graphical User Interface _[Global Fitting]: Simultaneously fitting multiple datasets with shared Parameters _[Goodness-of-fit]: Statistical measures (e.g., Chi-squared, R-squared) indicating how well a Model fits the observed data _[IDE]: Integrated Development Environment _[Initial Values]: The starting values assigned to Parameters before the optimization process begins _[Intensity]: The dependent variable (y-axis) in spectroscopy, representing the strength of the signal _[Integration]: Calculating the area under a curve, often used to quantify peak intensity _[IR]: Infrared Spectroscopy _[Iteration]: A single step or cycle within an optimization algorithm _[JSON]: JavaScript Object Notation _[Jupyter Notebook]: Web-based interactive computing environment for creating and sharing documents that contain live code, equations, visualizations, and narrative text _[JupyterLab]: Next-generation web-based user interface for Project Jupyter _[L-edge]: Features in X-ray Absorption Spectroscopy (XAS) arising from electron transitions from the L atomic shell (n=2) _[Least-Squares]: An optimization method that minimizes the sum of the squares of the Residuals between observed data and a Model _[Levenberg-Marquardt]: An iterative algorithm used for solving non-linear Least-Squares problems, the default Optimizer in lmfit _[Lorentzian]: A common peak function, also known as the Cauchy distribution, used in curve fitting _[Matplotlib]: Plotting library for the Python programming language _[Maximum Likelihood Estimation (MLE)]: Method for estimating the parameters of a statistical model given observations _[Metadata]: Data that provides information about other data (e.g., experimental conditions, sample details) _[Minimizer]: The lmfit class used for defining and performing the optimization (fitting) problem _[MkDocs Material]: A theme for the MkDocs static site generator, used for SpectraFit's documentation _[Model]: A mathematical function used to describe the data, often composed of one or more peak functions and a baseline, implemented using lmfit Models _[Model Component]: A distinct part of a composite Model, such as an individual peak or a baseline function _[Monte Carlo Methods]: Computational algorithms relying on repeated random sampling to obtain numerical results, sometimes used in error estimation _[Nelder-Mead]: A simplex-based optimization algorithm available in lmfit _[NetworkX]: Python library for the creation, manipulation, and study of complex networks _[Noise]: Random fluctuations in data that obscure the underlying signal _[Non-linear Fitting]: Curve fitting where the model depends non-linearly on its parameters _[Normalization]: Scaling data to a common range or standard, often between 0 and 1 or based on a specific feature _[NumPy]: Fundamental package for scientific computing with Python _[Objective Function]: The function that an optimization algorithm seeks to minimize or maximize (e.g., sum of squared residuals in Least-Squares) _[Optimizer]: The algorithm (e.g., Levenberg-Marquardt, Nelder-Mead) used by the Minimizer to find the best-fit Parameters _[Overfitting]: Fitting a model too closely to the noise or random fluctuations in the data, rather than the underlying trend _[Pandas DataFrames]: Two-dimensional, size-mutable, and potentially heterogeneous tabular data structures in the Pandas Python library _[Parameter Space]: The multi-dimensional space defined by the possible values of the model parameters _[Parameters]: The adjustable variables within a Model (e.g., amplitude, center, width) that are optimized during fitting _[Peak Shape]: The functional form used to describe a peak (e.g., Gaussian, Lorentzian, Voigt) _[Peak Width]: A measure of the extent of a peak along the independent variable axis, often characterized by FWHM or sigma _[Photon]: A quantum of electromagnetic radiation _[Pip]: The standard package installer for Python _[Pickle File]: Python's built-in serialization format _[Plotly]: A graphing library for creating interactive charts and dashboards _[Poetry]: Tool for Python dependency management and packaging _[PPTX]: PowerPoint file format _[Preprocessing]: Steps taken to prepare raw data for analysis (e.g., normalization, baseline correction, smoothing) _[Pseudo-Voigt]: A peak function approximating the Voigt profile, calculated as a linear combination or sum of Gaussian and Lorentzian shapes _[Pydantic]: Data validation and settings management library for Python _[Python]: High-level, interpreted, general-purpose programming language _[pytest]: A testing framework for Python code _[Quantification]: Determining the amount or concentration of a substance based on spectral features _[R-squared (R²)]: Coefficient of determination; a statistical measure of how well the regression predictions approximate the real data points (1 indicates perfect fit) _[Raman Spectroscopy]: Spectroscopic technique used to observe vibrational, rotational, and other low-frequency modes in a system _[Reduced Chi-squared (χ²_ν)]: Chi-squared divided by the Degrees of Freedom, providing a measure of Goodness-of-fit normalized by the number of free parameters _[Regression]: Statistical process for estimating the relationships between variables _[Repository]: A central location where code and its history are stored, typically using a VCS like Git _[Resolution (Spectral)]: The ability of a spectrometer to distinguish between closely spaced spectral features _[Residuals]: The differences between the observed data values and the values predicted by the fitted Model _[RIXS]: Resonant Inelastic X-ray Scattering _[Robust Fitting]: Fitting methods less sensitive to outliers in the data compared to standard Least-Squares _[Savitzky-Golay Filter]: A digital filter used for smoothing data and computing derivatives _[Scattering]: Process where waves or particles are deflected from a straight path due to interaction with other matter _[SciPy]: Open-source Python library used for scientific and technical computing _[SDK]: Software Development Kit _[Sensitivity Analysis]: Study of how the uncertainty in the output of a model can be attributed to different sources of uncertainty in its inputs or parameters _[Signal Processing]: Manipulation and analysis of signals, such as spectroscopic data _[Sigma (σ)]: The standard deviation parameter, often related to the width (FWHM) of peak functions like the Gaussian _[Simulation]: Imitation of the operation of a real-world process or system, e.g., simulating spectra based on a model _[Smoothing]: Applying algorithms to reduce noise in data, often using moving averages or Savitzky-Golay filters _[SpectraFit]: Software for analyzing and fitting spectroscopic data _[Spectroscopy]: Study of the interaction between matter and electromagnetic radiation as a function of wavelength or frequency _[Spectrum]: Data representing intensity as a function of energy, wavelength, frequency, or wavenumber _[Standard Deviation]: A measure of the amount of variation or dispersion of a set of values _[Standard Error]: An estimate of the standard deviation of a fitted Parameter, indicating its uncertainty _[TOML]: Tom's Obvious, Minimal Language _[Tolerance]: A threshold used in optimization algorithms to determine when convergence has been reached _[Trunk-Based Development]: A source-control branching model where developers collaborate on code in a single branch called 'trunk' (or main) _[Uncertainty]: The range of possible values within which the true value of a measurement or parameter lies _[Units]: Standard quantities used for measurement (e.g., eV, nm, cm⁻¹) _[UV-Vis]: Ultraviolet-Visible Spectroscopy _[Validation]: Process of checking if the model and its results are acceptable for the intended purpose _[Vary]: A boolean flag for a Parameter indicating whether its value should be adjusted (True) or kept fixed (False) during optimization _[VCS]: Version Control System _[Version Control]: System for tracking changes to files over time, like Git _[Visualization]: Creating graphical representations of data or models _[Voigt]: A peak function resulting from the Convolution of a Gaussian and a Lorentzian profile _[VS Code]: Visual Studio Code, a source-code editor _[Wavelength]: Spatial period of a periodic wave, inversely related to frequency and energy _[Wavenumber]: Spatial frequency, often used as the independent variable (x-axis) in IR and Raman spectroscopy (e.g., cm⁻¹) _[Weighting]: Assigning different levels of importance to data points during fitting, often based on their uncertainty _[Width]: General term for the extent of a peak, often quantified by FWHM or sigma _[XAS]: X-ray Absorption Spectroscopy _[XPS]: X-ray Photoelectron Spectroscopy _[X-ray]: Form of electromagnetic radiation with high energy _[YAML]: YAML Ain't Markup Language _[Zero Filling]: Adding zeros to the end of a time-domain signal before Fourier Transform to increase spectral resolution (interpolation) *[lmfit]: A Python library for Non-Linear Least-Squares Minimization and Curve Fitting